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