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