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