blob: cd64488e183373b9b7a1ab3bd28577a7496a88ae [file] [log] [blame]
MG Mud User88f12472016-06-24 23:31:02 +02001VORLAEUFIG
2SYNOPSIS
3 object present_clone(string str [, object env] );
4 object present_clone(object obj [, object env] );
5
6BESCHREIBUNG
7 Diese Efun durchsucht das Inventar von <env> nach einem Objekt mit
8 einem bestimmten Blueprint . Wird <env> nicht angegeben, wird in
9 this_object() gesucht. Der Blueprint kann entweder mit seinem Namen
10 <str> angegeben werden, oder als Blueprint des Objekts <obj>. Gesucht
11 wird in beiden Faellen aufgrund von load_name().
12 Wird kein passendes Objekt gefunden, liefert die Efun 0 zurueck.
13
14 Fuer Driver im Plain Modus beginnt der Name in jedem Fall mit '/', im
15 Compat Modus nicht.
16
17BEISPIELE
18 Angenommen, das Objekt <env> enthalte die Objekte /items/money#8,
19 /std/weapon#9, /std/weapon#12 und /obj/key in der angegeben
20 Reihenfolge.
21
22 +--------------------------------------------------+---------------+
23 | Funktion | Liefert |
24 +--------------------------------------------------+---------------+
25 | present_clone("/items/money", env) | /items/money#8|
26 | present_clone("/std/weapon#12", env) | /std/weapon#9 |
27 | present_clone(find_object("/items/money#1"), env)| /items/money#8|
28 | present_clone("/obj/key#18", env) | /obj/key |
29 +--------------------------------------------------+---------------+
30
31 Fuer Driver im Compat Modus liefert die Funktion keine '/' am Anfang.
32
33AENDERUNGEN
34 Eingefuehrt in 3.2.7.
35
36ANMERKUNG
37 Im Unterschied zu present() sucht present_clone() niemals in der
38 Umgebung von <env>.
39
40SIEHE AUCH
41 load_name(E), present(E)