blob: b487f4d0a2e80d393ebe400f774d4c2433337cf7 [file] [log] [blame]
MG Mud User88f12472016-06-24 23:31:02 +02001SYNOPSIS
2 unknown call_other(object ob, string fun, mixed arg, ...);
3 unknown call_other(object *ob, string fun, mixed arg, ...);
4
5 ob->fun(mixed arg, ...);
6 ob->"fun"(mixed arg, ...);
7 ob->(fun)(mixed arg, ...);
8
9BESCHREIBUNG
10 Ruft die in einem anderen Objekt <ob> die Funktion <fun> mit den
11 Argumenten <arg...> auf und gibt den Wert zurueck, der von der
12 Funktion <fun> geliefert wird (oder 0 fuer nicht existierende oder
13 als void deklarierte Funktionen).
14
15 Optional kann der Driver so konfigueriert werden, dass auch ein Array
16 von Objekten *<ob> akzeptiert wird. Die Funktion <fun> wird dann fuer
17 jedes Objekt <ob> im Array mit den Argumenten <arg...> aufgerufen.
18 Die einzelnen Resultate werden in einem Array zusammen gefasst und
19 dieses Array dann als Endresultat von call_other() zurueck gegeben.
20 Die Elemente von *<ob> koennen Objekte oder Namen von Objekten sein.
21 Zerstoerte Objekte und 0 als Element geben eine 0 zurueck, fuehren
22 aber nicht zu einem Fehler.
23 call_other() auf Arrays von Objekten ist im MG aktiviert, welches
24 durch das Define __LPC_ARRAY_CALLS__ angezeigt wird.
25
26 Das Objekt (bzw. die Objekte) kann direkt oder ueber einen String
27 (d.h. den Objektnamen) angegeben werden. Wenn ein String angegeben
28 wird und das Objekt noch nicht existiert, wird es geladen.
29
30 ob->fun(args) und "ob_name"->fun(args) sind aequivalent zu
31 call_other(ob, "fun", args). Heutzutage kann "ob_name" auch eine
32 Variable sein. ob->(fun)(args) ist aequivalent zu
33 call_other(ob, fun, args), wobei <fun> ein Runtime Ausdruck ist,
34 der den Funktionsnamen liefert.
35
36 Wenn das Objekt <ob> keine oeffentliche Funktion mit dem Namen <fun>
37 enthaelt, gibt call_other() den Wert 0 zurueck. Dies ist nicht
38 unterscheidbar von einer Funktion <fun>, die 0 zurueck liefert.
39 Oeffentlich bedeutet "public", wenn andere Objekte aufgerufen
40 werden und "public" oder "static", wenn der Aufruf an this_object()
41 ergeht. Funktionen, die "private" oder "protected" definiert sind,
42 koennen niemals von call_other() aufgerufen werden.
43
44 Der Rueckgabewert von call_other() ist standardmaessig 'any'. Falls
45 aber #pragma strict_types gesetzt ist, ist der Rueckgabewert
46 'unknown', und das Resultat des call_other() muss zuerst auf einen
47 zutreffenden Variablentyp gecastet werden, bevor man es fuer etwas
48 verwenden kann.
49
50BEISPIELE
51 Die nachfolgenden Beispiele rufen alle die Funktion "QueryProp" auf
52 mit dem Argument P_SHORT.
53
54 string str, fun;
55 str = (string)call_other(this_player(), "QueryProp", P_SHORT);
56 fun = "QueryProp";
57 str = (string)call_other(this_player(), fun, P_SHORT);
58
59 str = (string)this_player()->QueryProp(P_SHORT);
60 str = (string)this_player()->"QueryProp"(P_SHORT);
61 fun = "QueryProp";
62 str = (string)this_player()->(fun)(P_SHORT);
63
64 Solange #pragma strict_types gesetzt ist, muss man das Resultat von
65 call_other() explizit auf einen passenden Typ casten, weil
66 call_other() unknown liefert.
67
68 Das folgende Statement ruft die lfun short() in allen aktiven
69 Benutzern auf und speichert das gesammelte Resultat in einer
70 Variablen:
71
72 string * s;
73 s = (string *)users()->short();
74
75 Objekte laden (obsolet):
76 Compat: call_other("/users/luser/thing", "???", 0);
77
78 Das sieht etwas merkwuerdig aus, wurde aber oft verwendet, um einfach
79 ein Objekt zu laden. Dazu wurde die (nicht existierende) Funktion
80 "???" im Objekt aufgerufen. Gluecklicherweise gibt es heute zu
81 diesem Zweck die Efun load_object(), also bitte nicht mehr verwenden.
82
83AENDERUNGEN
84 In LDMud 3.2.8 wurden die folgenden Verbesserungen eingefuehrt:
85 - die Formen x->"y"() und x->(y)() werden erkannt;
86 - die Form x->y() kollidiert nicht mehr mit einer lokalen Variablen,
87 die auch "y" heisst.
88 - eine simul_efun call_other() erwischt auch Aufrufe der Form ->().
89 - call_other kann auch auf Arrays von Objekten angewandt werden.
90 LDMud 3.2.10 machte den Aufruf von Objektarrays konfigurierbar.
91
92SIEHE AUCH
93 function_exists(E), call_resolved(E), create(A), pragma(LPC),
94 extern_call(E), functions(LPC)