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