TriggerEvent()
==============

FUNKTION
--------
::

     varargs int TriggerEvent(string eid, mixed data);

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

     /p/daemon/eventd.c

DEKLARIERT IN
-------------
::

     /sys/events.h

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

     string eid,
       Die ID des Events, der ausgeloest werden soll.
       Da dieser String fuer alle Events jeweils eindeutig sein muss, 
       empfiehlt es sich, fuer eigene Events z.B. als Praefix den eigenen 
       Magiernamen zu nehmen, z.B. "zesstra_vulkanausbruch".
       ACHTUNG: IDs, die mit 'evt_lib_' beginnen, sind AUSSCHLIESSLICH der
       Mudlib vorbehalten!

     mixed data,
       Daten, die jeder Lauscher uebergeben bekommt. Kann ein beliebiger
       Datentyp sein. Ggf. ein Mapping oder Array benutzen.

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

     Der Event mit der ID 'eid' wird ausgeloest. Mit kurzer Verzoegerung
     (meist 0-2s) werden alle fuer 'eid' registrierten Lauscher durch Aufruf
     einer Funktion in ihnen informiert:
     listener->fun(eid, triggerob, data);
     'triggerob' ist hierbei das Objekt, welche TriggerEvent() gerufen hat,
     'data' das, was das triggernde Objekte als Daten weiterverteilen moechte.
     Die einzelnen fun() in den lauschenden Objekten muessen wissen, was sie
     mit 'data' anfangen sollen. ;-)

RUeCKGABEWERT
-------------
::

     1 fuer Erfolg, <=0 fuer Misserfolg.
     1   - Erfolg, Event 'eid' wurde ausgeloest.
     -1  - falsche Argumente wurden uebergeben
     -2  - nicht-oeffentlicher Event und das triggernde Objekt wurde nicht
           fuer diesen Event freigegeben (momentan gibt es noch keine
           nicht-oeffentlichen Events)
     -3  - Event 'eid' existiert nicht, d.h. es gibt keine Lauscher.
     -4  - Es gibt zuviele nicht verarbeitete Events.

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

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

     1. Ein Waechter wird angegriffen:
        EVENTD->TriggerEvent("xand_holzfaellerlager_angriff", 
                             (["angreifer": enemy,
                               "ort": environment(this_object()) ]) );
        Alle anderen angemeldeten Waechter der Lagers werden nun informiert
        und koennen ihrerseits reagieren (dem ersten Waechter zuhilfe kommen
        oder auch die Lagertore schliessen).

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

     events, eventd, UnregisterEvent(), RegisterEvent()


Last modified: 15.08.2007, Zesstra