blob: 6d9bfb79f3317a8d2d76f1098972c3c681025bec [file] [log] [blame]
MG Mud User88f12472016-06-24 23:31:02 +02001
Zesstra953f9972017-02-18 15:37:36 +01002UnregisterEvent()
3*****************
MG Mud User88f12472016-06-24 23:31:02 +02004
MG Mud User88f12472016-06-24 23:31:02 +02005
Zesstra953f9972017-02-18 15:37:36 +01006FUNKTION
7========
MG Mud User88f12472016-06-24 23:31:02 +02008
Zesstra953f9972017-02-18 15:37:36 +01009 int UnregisterEvent(string eid, object listener);
MG Mud User88f12472016-06-24 23:31:02 +020010
MG Mud User88f12472016-06-24 23:31:02 +020011
Zesstra953f9972017-02-18 15:37:36 +010012DEFINIERT IN
13============
MG Mud User88f12472016-06-24 23:31:02 +020014
Zesstra953f9972017-02-18 15:37:36 +010015 /p/daemon/eventd.c
MG Mud User88f12472016-06-24 23:31:02 +020016
MG Mud User88f12472016-06-24 23:31:02 +020017
Zesstra953f9972017-02-18 15:37:36 +010018DEKLARIERT IN
19=============
MG Mud User88f12472016-06-24 23:31:02 +020020
Zesstra953f9972017-02-18 15:37:36 +010021 /sys/events.h
22
23
24ARGUMENTE
25=========
26
27 string eid,
28 Die ID des Events, vom dem man sich abmelden will.
29 object listener,
30 Das Objekt, das als Lauscher ausgetragen werden soll.
31
32
33BESCHREIBUNG
34============
35
36 Das Objekt 'listener' wird als Lauscher dieses Events ausgetragen. Ab
37 diesem Moment wird es bei Events vom Typ 'eid' nicht mehr informiert.
38
39 Hat der Event 'eid' im Anschluss keine Lauscher mehr, wird er implizit
40 geloescht.
41
42
43RUeCKGABEWERT
44=============
45
46 1 fuer Erfolg, <=0 fuer Misserfolg.
47 1 - Erfolg, 'listener' wurde eingetragen.
48 -1 - falsche Argumente uebergeben
49 -2 - 'listener' ist nicht fuer 'eid' registriert.
50
51
52BEMERKUNGEN
53===========
54
55 Wenn sich ein Objekt vor Zerstoerung nicht abmeldet, wird es ggf. beim
56 naechsten Auftreten von 'eid' automatisch ausgetragen.
57 Falls Blueprints nach Neuladen nicht automatisch angemeldet sein sollen,
58 sollten sie sich im remove() explizit abmelden.
59
60
61BEISPIELE
62=========
63
64 1. Ein Objekt moechte nicht mehr ueber Spielertode informiert werden:
65 EVENTD->UnregisterEvent(EVT_LIB_PLAYER_DEATH, this_object());
66
67 2. Ein Objekt moechte sich bei Zerstoerung abmelden:
68 varargs int remove(int silent) {
69 ...
70 EVENTD->UnregisterEvent("zesstra_vulkanausbruch",this_object());
71 }
72
73
74SIEHE AUCH
75==========
76
77 events, eventd, UnregisterEvent(), RegisterEvent()
78
MG Mud User88f12472016-06-24 23:31:02 +020079Last modified: 15.08.2007, Zesstra