blob: 229197bd90c34da4c21db88d866c17f3d6b39dd7 [file] [log] [blame]
MG Mud User88f12472016-06-24 23:31:02 +02001AddDetail()
2
3FUNKTION:
4 void AddDetail(string|string* keys,
5 string|string*|mapping|closure desc);
6
7DEFINIERT IN:
8 /std/thing/description.c
9
10ARGUMENTE:
11 keys
12 String oder Array von Strings mit den Namen der Details.
13 desc
14 String, Mapping, String-Array oder Closure mit/zur Beschreibung.
15
16BESCHREIBUNG:
17 Die Beschreibung der Details <keys> wird gesetzt. Wie die Details
18 bei der Untersuchung aussehen, haengt im wesentlichen vom Typ der
19 Beschreibung <desc> ab:
20 <desc> ist ein String.
21 Beim Untersuchen wird dieser String zurueckgegeben.
22 <desc> ist ein String-Array.
23 Beim Untersuchen wird zufaellig einer der Strings zurueckgegeben.
24 <desc> ist ein Mapping.
25 Das Mapping muss folgenden Aufbau haben:
26 ([0: "Defaulttext",
27 "rasse1": "r1text", ...]).
28
29 Falls fuer die Rasse des das Detail untersuchenden Spielers ein
30 Eintrag im Mapping existiert, wird der entsprechende Text
31 zurueckgegeben, ansonsten der Defaulttext. Auf diese Weise sind
32 rassenabhaengige Details moeglich. Siehe auch die Beispiele.
33 <desc> ist eine Closure.
34 In diesem Fall wird die Closure ausgefuehrt und das Ergebnis
35 zurueckgegeben. Die Closure bekommt dabei den Namen des Details
36 als Parameter uebergeben.
37
38 Fuer Details koennen Forscherpunkte eingetragen werden.
39
40BEISPIELE:
41 Ein schlichtes Detail:
42
43 AddDetail(({"sofa","couch"}), "Eine kleine Couch.\n");
44
45 Laengere Details sollten hierbei nicht per Hand umgebrochen werden,
46 sondern man kann hierzu die Funktion break_string() nutzen:
47
48 AddDetail("detail", break_string(
49 "Du wolltest es ja nicht anders, jetzt musst Du Dir dieses "
50 "fuerchterlich lange Detail durchlesen!!!", 78));
51
52 Noetige Zeilenumbrueche bei Zeilenlaengen groesser 77 werden so
53 automatisch generiert.
54 Ein rassenabhaengiges Detail:
55
56 AddDetail(({"bett","bettchen"}),
57 ([0 :"Eine kleines Bett.\n", // Der Defaulttext
58 "zwerg": // Die Rasse klein schreiben
59 "Das Bett laedt geradezu zu einem Nickerchen ein.\n"]));
60
61 Und nun ein Detail mit Closure (diese Version ersetzt das Verhalten
62 von AddSpecialDetail).
63
64 int hebel_betaetigt;
65 ...
66 string hebel(string str); // Funktion bekannt machen (Prototyping)
67 ...
68 AddDetail(({"hebel","schalter"}), #'hebel);
69 ...
70 string hebel(string key) {
71 if(hebel_betaetigt)
72 return "Der "+capitalize(key)+" steht auf EIN.\n";
73 else
74 return "Der "+capitalize(key)+" steht auf AUS.\n";
75 }
76
77 Man erhaelt verschiedene Ergebnisse beim Untersuchen, je nachdem
78 ob das Flag hebel_betaetigt gesetzt ist oder nicht.
79
80SIEHE AUCH:
81 Setzen: AddReadDetail(), AddSmells(), AddSounds(),
82 AddTouchDetail()
83 Loeschen: RemoveDetail(), RemoveReadDetail(), RemoveSmells(),
84 RemoveSounds(), RemoveTouchDetail()
85 Daten: P_DETAILS, P_READ_DETAILS, P_SMELLS, P_SOUNDS,
86 P_TOUCH_DETAILS, P_SPECIAL_DETAILS
87 Veraltet: AddSpecialDetail(), RemoveSpecialDetail(), P_READ_MSG
88 Sonstiges: GetDetail(), break_string()
89
9020.01.2015, Zesstra
91