blob: f26c1ead1bc181b1d4fddece16bf6b13fba897c1 [file] [log] [blame]
MG Mud User88f12472016-06-24 23:31:02 +02001SYNOPSIS
2 string load_name()
3 string load_name(object|string obj)
4
5BESCHREIBUNG
6 Die Funktion liefert den Namen, mit dem <obj> geladen wurde. <obj>
7 kann direkt als Objekt oder als String mit seinem Namen angegeben
8 werden.
9
10 Wenn <obj> ein Clon ist, liefert die Funktion den Namen des Blueprints.
11 Wenn <obj> ein Blueprint ist, liefert die Funktion den Namen des Files,
12 aus dem der Blueprint kompiliert wurde.
13
14 Wenn <obj> ueber seinen Namen angegeben wurde, aber nicht / nicht mehr
15 existiert, generiert die Funktion den Namen, wie er sein muesste und
16 gibt diesen zurueck. Wenn der angegebene Name ungueltig ist, liefert
17 die Funktion 0.
18
19 Als Spezialfall liefert die Funktion 0, wenn <ob> 0 ist.
20
21 Fuer virtuelle Objekte liefert load_name() den originalen Ladenamen
22 des Objekts, welches der virtuelle Compiler erzeugte.
23
24 Wird <obj> nicht angegeben, wird der Name fuer das momentan gueltige
25 Objekt angegeben.
26
27 Im Gegensatz zum object_name() kann der load_name() nicht durch
28 rename_object() oder einen VC veraendert werden. Ist ein <obj> jedoch
29 einem replace_program() unterworfen, spiegelt der load_name() nicht
30 mehr das effektive Verhalten des Objekts wider.
31
32BEISPIELE
33 object o;
34 o = clone_object("/std/thing");
35 write(load_name(o)); --> liefert "/std/thing" in !Compat Modus
36 und "std/thing" im Compat Modus
37 write(load_name("/std/thing")); --> gleich wie oben
38 write(load_name("/std/thing#4n5")); --> liefert 0
39
40GESCHICHTE
41 Eingefuehrt in LDMud 3.2.6.
42 Strings als Argumente sind moeglich seit 3.2.8.
43 0 ist zulaessig seit 3.2.9.
44
45SIEHE AUCH
46 clone_object(E), clonep(E), object_name(E), load_object(E),
47 replace_program(E), program_name(E), present_clone(E)