blob: dee5817071f3d50fc495b66d4760e06d3a04d158 [file] [log] [blame]
Zesstra18626972017-01-31 10:38:27 +01001put()
2=====
3
4FUNKTION
5--------
6::
7
8 public varargs int put(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 irgendwo hingesteckt werden soll.
22 object dest
23 Der Behaelter, in den das Objekt gesteckt werden soll.
24 mixed msg
25 Eine optionale Meldung, die anstelle von P_PUT_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 steckt das Objekt in einen Behaelter. Gibt o->move()
34 keinen positiven Wert zurueck, beispielsweise weil er das Objekt nicht
35 weggeben darf oder der Behaelter schon voll ist, bekommt er eine
36 entsprechende Fehlermeldung.
37
38RUECKGABEWERT
39-------------
40::
41
42 Wenn das Bewegen geklappt hat, 1, ansonsten 0.
43
44BEMERKUNG
45---------
46::
47
48 Diese Funktion ist dann sinnvoll, wenn man den Spieler ein Objekt irgendwo
49 hinstecken 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 sich das Objekt und der Behaelter ueberhaupt
54 in der Reichweite des Spielers/NPC befinden, das muss man ggf. selbst
55 ermitteln.
56
57SIEHE AUCH
58----------
59::
60
61 move(L), P_PUT_MSG, put_objects(L), P_NOINSERT_MSG, P_NOLEAVE_MSG,
62 P_TOO_MANY_MSG, P_TOO_HEAVY_MSG, P_ENV_TOO_HEAVY_MSG, P_NOGET, P_NODROP
63
64
65Last modified: Thu Aug 28 22:21:58 2008 by Amynthor
66