blob: ef88c8a6d6a7d46b4febfa14cfcf566e992c2324 [file] [log] [blame]
Zesstra18626972017-01-31 10:38:27 +01001give()
2======
3
4FUNKTION
5--------
6::
7
8 public varargs int give(object o, object dest, 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 uebergeben werden soll.
22 object dest
23 Der Spieler oder NPC, der das Objekt bekommen soll.
24 mixed msg
25 Eine optionale Meldung, die anstelle von P_GIVE_MSG oder der
26 Standardmeldung verwendet wird, oder -1, um die Meldung zu
27 unterdruecken.
28
29BESCHREIBUNG
30------------
31::
32
33 Der Spieler oder NPC uebergibt dem Empfaenger das Objekt. Gibt o->move()
34 keinen positiven Wert zurueck, beispielsweise weil das Objekt verflucht
35 ist oder der Empfaenger es nicht mehr tragen kann, bekommt er eine
36 entsprechende Fehlermeldung.
37
38RUECKGABEWERT
39-------------
40::
41
42 Wenn die Uebergabe geklappt hat, 1, ansonsten 0.
43
44BEMERKUNG
45---------
46::
47
48 Diese Funktion ist dann sinnvoll, wenn man den Spieler ein Objekt
49 weitergeben lassen und sich nicht selbst um die Fehlerbehandlung kuemmern
50 moechte - und da unzaehlige verschiedene Dinge schiefgehen koennen und
51 manche Objekte eigene Fehlermeldungen definieren, eigentlich immer.
52
53 Die Funktion prueft nicht, ob der Spieler/NPC der Objekt ueberhaupt hat,
54 das muss man ggf. selbst ermitteln.
55
56SIEHE AUCH
57----------
58::
59
60 move(L), P_GIVE_MSG, give_objects(L), give_notify(L),
61 P_NOINSERT_MSG, P_NOLEAVE_MSG, P_TOO_MANY_MSG,
62 P_TOO_HEAVY_MSG, P_ENV_TOO_HEAVY_MSG, P_NODROP
63
64
65Last modified: Thu Aug 28 22:21:19 2008 by Amynthor
66