blob: 39a26243715639f052c7bf689db5a82c9685fc69 [file] [log] [blame]
MG Mud User88f12472016-06-24 23:31:02 +02001give()
2
3FUNKTION:
4 public varargs int give(object o, object dest, mixed msg);
5
6DEFINIERT IN:
7 /std/living/put_and_get.c
8
9ARGUMENTE:
10 object o
11 Das Objekt, das uebergeben werden soll.
12 object dest
13 Der Spieler oder NPC, der das Objekt bekommen soll.
14 mixed msg
15 Eine optionale Meldung, die anstelle von P_GIVE_MSG oder der
16 Standardmeldung verwendet wird, oder -1, um die Meldung zu
17 unterdruecken.
18
19BESCHREIBUNG:
20 Der Spieler oder NPC uebergibt dem Empfaenger das Objekt. Gibt o->move()
21 keinen positiven Wert zurueck, beispielsweise weil das Objekt verflucht
22 ist oder der Empfaenger es nicht mehr tragen kann, bekommt er eine
23 entsprechende Fehlermeldung.
24
25RUECKGABEWERT:
26 Wenn die Uebergabe geklappt hat, 1, ansonsten 0.
27
28BEMERKUNG:
29 Diese Funktion ist dann sinnvoll, wenn man den Spieler ein Objekt
30 weitergeben lassen und sich nicht selbst um die Fehlerbehandlung kuemmern
31 moechte - und da unzaehlige verschiedene Dinge schiefgehen koennen und
32 manche Objekte eigene Fehlermeldungen definieren, eigentlich immer.
33
34 Die Funktion prueft nicht, ob der Spieler/NPC der Objekt ueberhaupt hat,
35 das muss man ggf. selbst ermitteln.
36
37SIEHE AUCH:
38 move(L), P_GIVE_MSG, give_objects(L), give_notify(L),
39 P_NOINSERT_MSG, P_NOLEAVE_MSG, P_TOO_MANY_MSG,
40 P_TOO_HEAVY_MSG, P_ENV_TOO_HEAVY_MSG, P_NODROP
41
42----------------------------------------------------------------------------
43Last modified: Thu Aug 28 22:21:19 2008 by Amynthor