blob: ed4bd69f410e11d0893e2b49c765664557e768e9 [file] [log] [blame]
MG Mud User88f12472016-06-24 23:31:02 +02001remove()
Zesstra953f9972017-02-18 15:37:36 +01002********
MG Mud User88f12472016-06-24 23:31:02 +02003
MG Mud User88f12472016-06-24 23:31:02 +02004
Zesstra953f9972017-02-18 15:37:36 +01005FUNKTION
6========
MG Mud User88f12472016-06-24 23:31:02 +02007
Zesstra953f9972017-02-18 15:37:36 +01008 varargs int remove(int silent);
MG Mud User88f12472016-06-24 23:31:02 +02009
MG Mud User88f12472016-06-24 23:31:02 +020010
Zesstra953f9972017-02-18 15:37:36 +010011DEFINIERT IN
12============
MG Mud User88f12472016-06-24 23:31:02 +020013
Zesstrabfab6ac2018-08-29 22:36:57 +020014 /std/thing/moving.c /std/living/moving.c /std/room/moving.c
15 /std/unit.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 +010018ARGUMENTE
19=========
20
Zesstrabfab6ac2018-08-29 22:36:57 +020021 * silent: Falls ungleich 0, so werden beim Zerstoeren keine
22 Meldungen ausgegeben.
Zesstra953f9972017-02-18 15:37:36 +010023
24
25BESCHREIBUNG
26============
27
Zesstrabfab6ac2018-08-29 22:36:57 +020028 Die meisten Objekte zerstoeren sich durch den Aufruf von remove()
29 selbst.
30
31 Unitobjekte reduzieren P_AMOUNT um U_REQ Einheiten. Will man ein
32 Unit- Objekt vollstaendig zerstoeren, ist vor dem Aufruf von
33 remove() U_REQ auf P_AMOUNT zu setzen. Wird durch remove() P_AMOUNT
34 0, wird das Objekt natuerlich zerstoert.
35
36 Durch Ueberladen dieser Funktion kann man diesen Vorgang noch durch
37 die Ausgabe von Meldungen kommentieren, oder irgendwelche Daten
38 abspeichern, oder das Zerstoeren ganz verhindern (auf diesem Weg...
39 Mit destruct() kann das Objekt immer noch direkt zerstoert werden!)
40
41 ACHTUNG: Wenn ein Objekt durch remove() nicht zerstoert wird,
42 koennte das einen Grund haben. Bitte nicht einfach destruct()
43 verwenden, das ist nur fuer Notfaelle wie ein buggendes remove().
Zesstra953f9972017-02-18 15:37:36 +010044
45
46RUeCKGABEWERT
47=============
48
49 1, wenn sich das Objekt erfolgreich selbst zerstoert hat, sonst 0.
50
51
52BEMERKUNGEN
53===========
54
Zesstrabfab6ac2018-08-29 22:36:57 +020055 Nach einem erfolgreichen ::remove() gelten die selben
56 Einschraenkungen wie nach einem destruct()!
Zesstra953f9972017-02-18 15:37:36 +010057
58
59SIEHE AUCH
60==========
61
Zesstra6cadc1b2018-11-15 22:27:32 +010062 *../efun/destruct*, U_REQ, P_AMOUNT
Zesstra953f9972017-02-18 15:37:36 +010063
Zesstrabfab6ac2018-08-29 22:36:57 +020064Letzte Aenderung: 24.07.2018, Bugfix