QuerySkillAttributeModifier()
=============================

FUNKTION
--------
::

    public varargs mapping QuerySkillAttributeModifier(object caster, 
                                                    string *atrnames)

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

    /std/living/skill_attributes.c

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

    <caster>    object
                Objekt, welches die gesuchten Mods gesetzt hat

    <atrnames>  string*
                Array von Skill-Attributen, welche durchsucht werden sollen.

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

    Diese Funktion liefert alle Mods von <caster> auf den Skill-
    Attributen <atrnames> in einem Mapping zurueck.
    Wird <atrnames> nicht angegeben oder ist ein leeres Array, werden alle
    Skill-Attribute nach Mods abgesucht.
    Wird <caster> nicht angeben oder ist 0, so werden alle Mods der 
    gewuenschten Skill-Attribute geliefert.
    Dementsprechend bekommt man alle Mods aller Skill-Attribute, wenn keins
    von beidem angegeben wird.

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

    ([]), falls keine Modifikatoren gefunden wurden.
    In anderen Faellen ist die Datenstruktur des Mappings wie folgt:
    ([ atrname1: ([ <caster>: <value>; <duration> ]),
       atrname2: ([ <caster>: <value>; <duration> ]) ])
    Die Schluessel im Mapping sind die jeweiligen Skill-Attribute, die Werte
    des Mappings sind erneut Mappings, welche als Schluessel die Objekte
    haben, welche die Mods gesetzt haben. In diesem Mapping gehoeren zu jedem
    Schluessel zwei Werte, den Wert des Modifikators und die Ablaufzeit.
    <value> kann hierbei ein int oder eine closure sein, <duration> ist ein
    int, <caster> ist ein Objekt.
    Ggf. kann das innere Mapping natuerlich auch mehrere Modifikatoren
    enthalten (also caster1, caster2, usw.).

BEMERKUNGEN
-----------
::

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

     Ein Objekt moechte seinen bestehenden Modifikator um 20 und die
     Gueltigkeit um 13 erhoehen.
     mapping res = ob->QuerySkillAttributeModifier(this_object(),
                                                  ({SA_DAMAGE}) );
     if (member(res, SA_DAMAGE) && member(res[SA_DAMAGE], this_object())) {
          // alten Mod ueberschreiben und Werte dabei anheben.
          ob->ModifySkillAttributeModifier(SA_DAMAGE,
              res[SA_DAMAGE][this_object(),0] + 20,
              res[SA_DAMAGE][this_object(),1] + 13 );
     }
     else
          // neuen Mod setzen.
          ob->ModifySkilAttributeModifier(SA_DAMAGE, 20, 13);

      

     Ein Objekt hat den Fluch der unpraezisen Schnelligkeit, welcher SA_DAMAGE
     reduziert, sofern das Lebewesen einen positiven Modifikator auf SA_SPEED
     hat:
     mapping res = ob->QuerySkillAttributeModifier(0, ({SA_SPEED}) );
     if (member(res, SA_SPEED) {
         int val, int dur;
         foreach(object caster, int v, int d: res[SA_SPEED]) {
             // groessten Mod rausfinden, dabei keine closures
             // beruecksichtigen.
             if (intp(v) && v>val) {
                 val=v;
                 dur=d;
             }
         }
         if (val > 0) {
             // pos. Mod auf SA_SPEED gefunden, entsprechenden neg. Mod auf
             // SA_DAMAGE setzen, der zum gleichen Zeitpunkt ungueltig wird
             // wie der Mod auf SA_SPEED.
             if (ob->ModifySkillAttribute(SA_DAMAGE, -val, dur) == SA_MOD_OK)
                tell_object(ob, "tolle Fluchmeldung.");
         }
     }

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

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

14.08.2008, Zesstra