Gitiles
Code Review Sign In
gerrit.morgengrauen.info / mudlib-public / 2e97b6af5b7b7de4683c32647db33d374df5e769 / . / doc / lfun / RemoveExtraLook
blob: 617e0b4afe61d5351c6774233be329ffbe926b35 [file] [log] [blame]
Zesstra953f9972017-02-18 15:37:36 +0100[diff] [blame]1
2RemoveExtraLook()
3*****************
4
MG Mud User88f12472016-06-24 23:31:02 +0200[diff] [blame]5
Zesstra0c1a85a2018-02-07 23:46:50 +0100[diff] [blame]6FUNKTION
7========
MG Mud User88f12472016-06-24 23:31:02 +0200[diff] [blame]8
Zesstra09cd00b2019-11-28 21:23:35 +0100[diff] [blame]9 int RemoveExtraLook(string key);
Zesstra953f9972017-02-18 15:37:36 +0100[diff] [blame]10
11
12DEFINIERT IN
13============
14
MG Mud User88f12472016-06-24 23:31:02 +0200[diff] [blame]15 /std/living/description.c
16
Zesstra953f9972017-02-18 15:37:36 +0100[diff] [blame]17
Zesstra0c1a85a2018-02-07 23:46:50 +0100[diff] [blame]18ARGUMENTE
19=========
20
21 * string key: Schluessel, unter dem der Extralook registriert
22 wurde ODER Objektname des registrierenden Objektes
23
24
Zesstra953f9972017-02-18 15:37:36 +0100[diff] [blame]25BESCHREIBUNG
26============
27
MG Mud User88f12472016-06-24 23:31:02 +0200[diff] [blame]28 Der Extralook erscheint in der Langbeschreibung des Lebewesens.
MG Mud User88f12472016-06-24 23:31:02 +0200[diff] [blame]29
Zesstra0c1a85a2018-02-07 23:46:50 +0100[diff] [blame]30 Eintraege koennen mit dieser Funktion (vorzeitig) wieder entfernt
31 werden. Dazu wird entweder der selbst festgelegte Schluessel oder
32 der implizite Schluessel *object_name()* des setzenden Objekts
33 benoetigt.
Zesstra953f9972017-02-18 15:37:36 +0100[diff] [blame]34
35
36BEMERKUNGEN
37===========
38
Zesstra0c1a85a2018-02-07 23:46:50 +0100[diff] [blame]39 Beim Entfernen mit dieser Funktion wird die "Endemeldung" des
40 entfernten Eintrages nicht ausgegeben.
41
42
43RUECKGABEWERTE
44==============
45
46 Siehe auch /sys/living/description.h fuer Konstanten.
47
48 * 1, falls der Eintrag erfolgreich entfernt wurde.
49
50 * < 0 sonst.
51
52 * -1: keinen (gueltigen) <key> uebergeben.
53
54 * -2: kein Eintrag fuer <key> gefunden.
Zesstra953f9972017-02-18 15:37:36 +0100[diff] [blame]55
56
57BEISPIELE
58=========
59
Zesstra0c1a85a2018-02-07 23:46:50 +0100[diff] [blame]60 // (1) Loeschen ueber expliziten Key
61 living->AddExtraLook(
62 "@WER1 wird von einer Horde Daemonen verfolgt.",
63 1800, "ennox_daemonenhordenverfolgerlook");
64
65 // Nun kann der Eintrag auch wieder entfernt werden:
Zesstra953f9972017-02-18 15:37:36 +0100[diff] [blame]66 living->RemoveExtraLook("ennox_daemonenhordenverfolgerlook");
67
Zesstra0c1a85a2018-02-07 23:46:50 +0100[diff] [blame]68 // (2) Loeschen ueber impliziten Objektnamen-Schluessel
69 living->AddExtraLook("Eine Sonnenblume ragt aus dem Ohr.")
70 // das ist nur aus dem gleichen Objekt heraus moeglich:
71 living->RemoveExtraLook(0);
72
73 // (3) Loeschen ueber impliziten Objektnamen-Schluessel
74 string implizite_id = object_name(this_object());
75 living->AddExtraLook("Eine Sonnenblume ragt aus dem Ohr.")
76 // diese ID kann man natuerlich durch die Gegend schicken
77 living->RemoveExtraLook(implizite_id);
78
Zesstra953f9972017-02-18 15:37:36 +0100[diff] [blame]79
80SIEHE AUCH
81==========
82
Zesstra0c1a85a2018-02-07 23:46:50 +0100[diff] [blame]83 Verwandt:
Zesstra09cd00b2019-11-28 21:23:35 +0100[diff] [blame]84 AddExtraLook(), P_INTERNAL_EXTRA_LOOK, HasExtraLook()
MG Mud User88f12472016-06-24 23:31:02 +0200[diff] [blame]85
Zesstra0c1a85a2018-02-07 23:46:50 +0100[diff] [blame]86 Sonstiges:
Zesstra6cadc1b2018-11-15 22:27:32 +0100[diff] [blame]87 replace_personal(), break_string()
Zesstra0c1a85a2018-02-07 23:46:50 +0100[diff] [blame]88
89 Fuer Spielerobjekte:
Zesstra6cadc1b2018-11-15 22:27:32 +0100[diff] [blame]90 P_EXTRA_LOOK
Zesstra0c1a85a2018-02-07 23:46:50 +0100[diff] [blame]91
9215. Jun 2017 Gloinson