pick_objects()
**************


FUNKTION
========

   public varargs int pick_objects(string str, int flag, mixed msg);


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

   /std/living/put_and_get.c


ARGUMENTE
=========

   string str
       Was aufgehoben werden soll.
   int flag
       Muss das Objekt irgendwo drinstecken (flag = 1), oder darf es einfach
       so herumliegen (flag = 0)? Dieses Argument ist hauptsaechlich fuer das
       Kommando "hole" gedacht, in der Regel braucht man es nicht anzugeben.
   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 die in <str> benannten Sachen. Kann er ein
   Objekt nicht nehmen, bekommt er eine entsprechende Fehlermeldung. Wenn
   keine Objekte auf <str> passen, wird per _notify_fail() eine Meldung
   gesetzt, aber noch nicht ausgegeben.


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

   Wenn <str> irgendwelche vorhandenen Sachen sind, 1, sonst 0.


BEMERKUNG
=========

   Wenn die Funktion 1 zurueckgibt, heisst das noch nicht, dass der Spieler
   etwas genommen hat! Er hat es nur versucht, d.h. auf jeden Fall eine
   Meldung bekommen. Gibt die Funktion 0 zurueck, hat er noch keine bekommen.


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

   move(L), pick(L), P_PICK_MSG, find_objects(L), moved_objects(L)

Last modified: Fri Jul 25 10:58:43 2008 by Amynthor