blob: 36147c306933b11308cf660110fb2094d0d69e7b [file] [log] [blame]
Zesstra18626972017-01-31 10:38:27 +01001drop()
2======
3
4FUNKTION
5--------
6::
7
8 public varargs int drop(object o, mixed msg);
9
10DEFINIERT IN
11------------
12::
13
14 /std/living/put_and_get.c
15
16ARGUMENTE
17---------
18::
19
20 object o
21 Das Objekt, das fallengelassen werden soll.
22 mixed msg
23 Eine optionale Meldung, die anstelle von P_DROP_MSG oder der
24 Standardmeldung verwendet wird, oder -1, um die Meldung zu
25 unterdruecken.
26
27BESCHREIBUNG
28------------
29::
30
31 Der Spieler oder NPC laesst das Objekt fallen. Gibt o->move() keinen
32 positiven Wert zurueck, beispielsweise weil das Objekt verflucht ist,
33 bekommt er eine entsprechende Fehlermeldung.
34
35RUECKGABEWERT
36-------------
37::
38
39 Wenn das Fallenlassen geklappt hat, 1, ansonsten 0.
40
41BEMERKUNG
42---------
43::
44
45 Diese Funktion ist dann sinnvoll, wenn man den Spieler ein Objekt
46 fallenlassen lassen und sich nicht selbst um die Fehlerbehandlung kuemmern
47 moechte - und da unzaehlige verschiedene Dinge schiefgehen koennen und
48 manche Objekte eigene Fehlermeldungen definieren, eigentlich immer.
49
50 Die Funktion prueft nicht, ob der Spieler/NPC das Objekt ueberhaupt hat,
51 das muss man ggf. selbst ermitteln.
52
53BEISPIEL
54--------
55::
56
57 if (this_player()->drop(obj, ({
58 "Du wirfst @WEN2 in den Saeureteich.\n",
59 "@WER1 wirft @WENU2 in den Saeureteich.\n" })))
60 obj->remove();
61
62SIEHE AUCH
63----------
64::
65
66 move(L), P_DROP_MSG, drop_objects(L), P_NOINSERT_MSG, P_NOLEAVE_MSG,
67 P_TOO_MANY_MSG, P_TOO_HEAVY_MSG, P_ENV_TOO_HEAVY_MSG, P_NODROP
68
69
70Last modified: Thu Aug 28 22:20:37 2008 by Amynthor
71