blob: 33e7eafc851c4891d8b63a2c59de84f7da33929c [file] [log] [blame]
MG Mud User88f12472016-06-24 23:31:02 +02001put()
2
3FUNKTION:
4 public varargs int put(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 irgendwo hingesteckt werden soll.
12 object dest
13 Der Behaelter, in den das Objekt gesteckt werden soll.
14 mixed msg
15 Eine optionale Meldung, die anstelle von P_PUT_MSG oder der
16 Standardmeldung verwendet wird, oder -1, um die Meldung zu
17 unterdruecken.
18
19BESCHREIBUNG:
20 Der Spieler oder NPC steckt das Objekt in einen Behaelter. Gibt o->move()
21 keinen positiven Wert zurueck, beispielsweise weil er das Objekt nicht
22 weggeben darf oder der Behaelter schon voll ist, bekommt er eine
23 entsprechende Fehlermeldung.
24
25RUECKGABEWERT:
26 Wenn das Bewegen geklappt hat, 1, ansonsten 0.
27
28BEMERKUNG:
29 Diese Funktion ist dann sinnvoll, wenn man den Spieler ein Objekt irgendwo
30 hinstecken 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 sich das Objekt und der Behaelter ueberhaupt
35 in der Reichweite des Spielers/NPC befinden, das muss man ggf. selbst
36 ermitteln.
37
38SIEHE AUCH:
39 move(L), P_PUT_MSG, put_objects(L), P_NOINSERT_MSG, P_NOLEAVE_MSG,
40 P_TOO_MANY_MSG, P_TOO_HEAVY_MSG, P_ENV_TOO_HEAVY_MSG, P_NOGET, P_NODROP
41
42----------------------------------------------------------------------------
43Last modified: Thu Aug 28 22:21:58 2008 by Amynthor