pick()
******


FUNKTION
========

   public varargs int pick(object o, mixed msg);


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

   /std/living/put_and_get.c


ARGUMENTE
=========

   object o
       Das Objekt, das aufgehoben werden soll.
   mixed msg
       Eine optionale Meldung, die anstelle von P_PICK_MSG oder der
       Standardmeldung verwendet wird, oder -1, um die Meldung zu
       unterdruecken.


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

   Der Spieler oder NPC nimmt das Objekt auf. Gibt o->move() keinen positiven
   Wert zurueck, beispielsweise weil das Objekt zu schwer ist oder nicht
   genommen werden darf, bekommt er eine entsprechende Fehlermeldung.


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

   Wenn das Aufnehmen geklappt hat, 1, ansonsten 0.


BEMERKUNG
=========

   Diese Funktion ist dann sinnvoll, wenn man den Spieler ein Objekt
   aufnehmen 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 ueberhaupt in der Reichweite
   des Spielers/NPC befindet, das muss man ggf. selbst ermitteln.


BEISPIEL
========

   ob = clone_object(WEINGUMMI);

   if (this_player()->pick(ob, ({ "Du nimmst @WENU2 aus dem Regal.",
                                  "@WER1 nimmt @WENU2 aus dem Regal." })))
       weingummi--;
   else
       ob->remove();


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

   move(L), P_PICK_MSG, pick_objects(L), P_NOINSERT_MSG, P_NOLEAVE_MSG,
   P_TOO_MANY_MSG, P_TOO_HEAVY_MSG, P_ENV_TOO_HEAVY_MSG, P_NOGET

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