Morgengrauner Dokumentation

Dateipfad: /home/mud/mudlib/doc/efun/present_clone
VORLAEUFIG
SYNOPSIS
        object present_clone(string str)
        object present_clone(string str, int n)
        object present_clone(string str, object env)
        object present_clone(string str, object env, int n)

        object present_clone(object obj)
        object present_clone(object obj, int n)
        object present_clone(object obj, object env)
        object present_clone(object obj, object env, int n)

BESCHREIBUNG
        Diese Efun durchsucht das Inventar von  nach einem Objekt mit
        einem bestimmten Blueprint. Wird  nicht angegeben, wird in
        this_object() gesucht. Der Blueprint kann entweder mit seinem Namen
         angegeben oder als Blueprint des Objekts  werden. Gesucht
        wird in beiden Faellen aufgrund von load_name().
        Wird  angegeben, wird das . Objekt in  gesucht, ansonsten
        das 1. in .
        Wird kein passendes Objekt gefunden, wird 0 zurueckgegeben.

        Fuer Driver im Plain Modus beginnt der Name in jedem Fall mit '/', im
        Compat Modus nicht.

BEISPIELE
        Angenommen, das Objekt  enthalte die Objekte /obj/money#8,
        /std/weapon#9, /std/weapon#12 und /obj/key in der angegeben
        Reihenfolge.

        +--------------------------------------------------+---------------+
        | Funktion                                         | Liefert       |
        +--------------------------------------------------+---------------+
        | present_clone("/obj/money", env)                 | /obj/money#8  |
        | present_clone("/std/weapon#12", env)             | /std/weapon#9 |
        | present_clone(find_object("/obj/money#14"), env) | /obj/money#8  |
        | present_clone("/obj/key#18", env)                | /obj/key      |
        | present_clone("/std/weapon#12", env, 2)          | /std/weapon#12|
        | present_clone("/std/weapon#12", env, 3)          | 0             |
        +--------------------------------------------------+---------------+

        Fuer Driver im Compat Modus liefert die Funktion keine '/' am Anfang.

ANMERKUNGEN
        Im Unterschied zu present() sucht present_clone() niemals in der
        Umgebung von .

GESCHICHTE
        Eingefuehrt in 3.2.7.
        Die Suche nach dem -ten Objekt wurde in 3.3.718 ergaenzt.

SIEHE AUCH
        load_name(E), present(E)

zurück zur Übersicht