put()
*****


FUNKTION
========

   public varargs int put(object o, object dest, mixed msg);


DEFINIERT IN
============

   /std/living/put_and_get.c


ARGUMENTE
=========

   object o
       Das Objekt, das irgendwo hingesteckt werden soll.
   object dest
       Der Behaelter, in den das Objekt gesteckt werden soll.
   mixed msg
       Eine optionale Meldung, die anstelle von P_PUT_MSG oder der
       Standardmeldung verwendet wird, oder -1, um die Meldung zu
       unterdruecken.


BESCHREIBUNG
============

   Der Spieler oder NPC steckt das Objekt in einen Behaelter. Gibt o->move()
   keinen positiven Wert zurueck, beispielsweise weil er das Objekt nicht
   weggeben darf oder der Behaelter schon voll ist, bekommt er eine
   entsprechende Fehlermeldung.


RUECKGABEWERT
=============

   Wenn das Bewegen geklappt hat, 1, ansonsten 0.


BEMERKUNG
=========

   Diese Funktion ist dann sinnvoll, wenn man den Spieler ein Objekt irgendwo
   hinstecken lassen und sich nicht selbst um die Fehlerbehandlung kuemmern
   moechte - und da unzaehlige verschiedene Dinge schiefgehen koennen und
   manche Objekte eigene Fehlermeldungen definieren, eigentlich immer.

   Die Funktion prueft nicht, ob sich das Objekt und der Behaelter ueberhaupt
   in der Reichweite des Spielers/NPC befinden, das muss man ggf. selbst
   ermitteln.


SIEHE AUCH
==========

   move(L), P_PUT_MSG, put_objects(L), P_NOINSERT_MSG, P_NOLEAVE_MSG,
   P_TOO_MANY_MSG, P_TOO_HEAVY_MSG, P_ENV_TOO_HEAVY_MSG, P_NOGET, P_NODROP

Last modified: Thu Aug 28 22:21:58 2008 by Amynthor