doc/lfun/drop

drop()
******


FUNKTION
========

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


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

   /std/living/put_and_get.c


ARGUMENTE
=========

   object o
       Das Objekt, das 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 das Objekt fallen. Gibt o->move() keinen
   positiven Wert zurueck, beispielsweise weil das Objekt verflucht ist,
   bekommt er eine entsprechende Fehlermeldung.


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

   Wenn das Fallenlassen geklappt hat, 1, ansonsten 0.


BEMERKUNG
=========

   Diese Funktion ist dann sinnvoll, wenn man den Spieler ein Objekt
   fallenlassen 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 der Spieler/NPC das Objekt ueberhaupt hat,
   das muss man ggf. selbst ermitteln.


BEISPIEL
========

   if (this_player()->drop(obj, ({
           "Du wirfst @WEN2 in den Saeureteich.\n",
           "@WER1 wirft @WENU2 in den Saeureteich.\n" })))
       obj->remove();


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

   move(L), P_DROP_MSG, drop_objects(L), P_NOINSERT_MSG, P_NOLEAVE_MSG,
   P_TOO_MANY_MSG, P_TOO_HEAVY_MSG, P_ENV_TOO_HEAVY_MSG, P_NODROP

Last modified: Thu Aug 28 22:20:37 2008 by Amynthor