RemoveSkillAttributeModifier()
==============================

FUNKTION
--------
::

    public int RemoveSkillAttributeModifier(object caster, string atrname)

DEFINIERT IN
------------
::

    /std/living/skill_attributes.c

ARGUMENTE
---------
::

    <atrname>   string
                Name des Skill-Attributes, von dem der Modifikator geloescht
                werden soll.
                (Definiert in /sys/living/skill_attributes.h)

    <caster>    object
                Objekt, dessen Modifikator wieder entfernt werden soll.

BESCHREIBUNG
------------
::

    Entfernt den Modifikator, den Object <caster> gesetzt hat, wieder. Dies
    ist nur notwendig, wenn der Effekt vor Ablauf der Gueltigkeit des
    Modifikators aufgehoben werden soll.

RUECKGABEWERT
-------------
::

    SA_MOD_REMOVED         wenn der Modifikator geloescht wurde
    SA_MOD_NOT_FOUND       wenn der Modifikator nicht gefunden wurde
    Wenn man nur wissen will, ob die Operation erfolgreich war, empfiehlt es
    sich, auf == SA_MOD_REMOVED zu pruefen.

BEISPIELE
---------
::

    // eine Waffe setzt im InformWield() einen Bonus auf SA_DAMAGE fuer 10min
    protected void InformWield(object pl, int silent) {
      if (objectp(pl)) {
        if (pl->ModifySkillAttribute(SA_DAMAGE, 20, 600) == SA_MOD_OK)
          // Erfolgsmeldung an Spieler
        else
          // Misserfolgsmeldung an Spieler.
      }
    }

    // wenn der Spieler die Waffe vor Ablauf der 600s wegstecken will, muss
    // der Bonus natuerlich auch wieder raus
    protected void InformUnwield(object pl, int silent) {
      if (objectp(pl))
        pl->RemoveSkillAttributeModifier(this_object(), SA_DAMAGE);
        // falls kein solcher Mod mehr gesetzt war, liefert RSAM()
        // SA_MOD_NOT_FOUND zurueck. Auswertung des Rueckgabewertes ist
        // vernachlaessigt.
    }

    

SIEHE AUCH
----------
::

    Skills Lernen:  LearnSkill, ModifySkill, LimitAbility
    * Nutzung:      UseSpell, UseSkill
    * Abfragen:     QuerySkill, QuerySkillAbility
    * Modifikation: ModifySkillAttribute, QuerySkillAttribute,
                    QuerySkillAttributeModifier
      * Properties: P_SKILL_ATTRIBUTES, P_SKILL_ATTRIBUTE_OFFSETS
    * sonstig:      spruchermuedung, skill_info_liste
    * Properties:   P_NEWSKILLS

13.08.2008, Zesstra