doc/lfun/drop_objects

drop_objects()
**************


FUNKTION
========

   public varargs int drop_objects(string str, mixed msg);


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

   /std/living/put_and_get.c


ARGUMENTE
=========

   string str
       Was fallengelassen werden soll.
   mixed msg
       Eine optionale Meldung, die anstelle von P_DROP_MSG oder der
       Standardmeldung verwendet wird, oder -1, um die Meldung zu
       unterdruecken.


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

   Der Spieler oder NPC laesst die in <str> benannten Sachen fallen.
   Kann er ein Objekt nicht fallenlassen, 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 fallengelassen hat! Er hat es nur versucht, d.h. auf jeden Fall eine
   Meldung bekommen. Gibt die Funktion 0 zurueck, hat er noch keine bekommen.


BEISPIEL
========

   private int cmd_opfern(string str)
   {
       notify_fail("WAS moechtest Du opfern?\n");

       if (!this_player()->drop_objects(str, ({ "Du opferst @WEN2.",
                                                "@WER1 opfert @WENU2.\n" })))
           return 0;

       filter_objects(this_player()->moved_objects(), "remove");
       return 1;
   }


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

   move(L), drop(L), P_DROP_MSG, find_objects(L), moved_objects(L)

Last modified: Fri Jul 25 10:59:37 2008 by Amynthor