blob: 9763999d5e40103c4267b734390db82b0da48ba0 [file] [log] [blame]
MG Mud User88f12472016-06-24 23:31:02 +02001Configure()
2
3 public mixed Configure(mixed data)
4
5DEFINIERT IN:
6 Beliebigen Objekten
7
8ARGUMENTE:
9 <data>
10 0 fuer Datenabfrage
11 beliebige Daten, die ein Configure(0) vorher lieferte
12
13BESCHREIBUNG:
14 Viele Objekte werden fuer bestimmte Spieler konfiguriert und so
15 personalisiert. Sie enthalten zusaetzlich zu den Daten, welche waehrend des
16 create() gesetzt wurden, noch weitere spieler-individuelle Daten.
17 Damit diese Objekte im Bedarfsfall neu erstellt werden koennen, sollte ein
18 geeignetes Configure() definfiert werden, um diese Daten abzurufen und in
19 einem neuen Clone (oder neugeladener Blueprint) wieder zu setzen.
20
21 Existiert Configure() im Objekt, MUSS dieses bei einem Aufruf mit
22 <data>==0 (d.h. Configure(0)) alle individuellen Daten zurueckliefern,
23 die noetig sind, um den aktuellen Zustand des Objektes spaeter
24 wiederherzustellen.
25 Das Objekt darf nach dem Zurueckgeben dieser Daten diese NICHT mehr
26 veraendern, d.h. es muss ggf. eine Kopie erstellt werden (copy, deep_copy)
27
28 Genau diese Daten werden in einem neu geclonten Objekt durch den Aufruf
29 von Configure(data) wieder gesetzt. Das Configure MUSS genau die Daten, die
30 es im alten Objekt zurueckliefert, wieder akzeptieren.
31
32RUeCKGABEWERT:
33 Wenn <data>==0:
34 Alle individuellen Daten in einer beliebigen Form. Ein Mapping bietet
35 sich jedoch an.
36 Nicht erlaubt sind: Objekte und Closures.
37
38 Wenn <data>!=0:
39 1, wenn die Daten zur Konfiguration akzeptiert wurden.
40 0, sonst.
41
42BEMERKUNGEN:
43 Configure() ist nicht verpflichtet, erneut Daten zu akzeptieren, wenn es
44 bereits einmal mit gueltigen Daten aufgerufen wurde.
45 Das Zurueckschreiben der Daten kann auch nach Ablauf laengerer Zeit
46 und/oder in einer anderen Uptime erfolgen.
47
48BEISPIELE:
49 Ein Objekt, welches ein anderes Objekt sicher ersetzt, d.h. die
50 individuelle Konfiguration bleibt erhalten:
51 mixed data;
52 if (call_resolved(data,ob,"Configure",0) == 1) {
53 string obname = load_name(ob);
54 ob->remove();
55 ob = clone_object(obname);
56 if (data) {
57 if (ob->Configure(data) == 1) {
58 printf("Instanz von %s erfolgreich ersetzt, neues Objekt: %O\n",
59 obname,ob);
60 }
61 else {
62 raise_error(sprintf("Configure() in %O akzeptierte Daten nicht!\n",
63 ob));
64 }
65 }
66 }
67 else {
68 printf(break_string(
69 "Das Objekt %O definiert keine Funktion Configure(). Es kann "
70 "nicht sicher ersetzt werden, da unbekannt ist, ob es individuelle "
71 "Daten enthaelt.",78));
72 }
73
74LETZTE AeNDERUNG:
7526.09.2011, Zesstra
76