blob: 24802ef306286c2fb005e89046bdd3a0ba53dfbc [file] [log] [blame]
Zesstrad59c3892019-11-28 20:53:39 +01001GESCHUETZT
2SYNOPSIS
MG Mud User88f12472016-06-24 23:31:02 +02003 string traceprefix(string prefix)
4 string traceprefix(int dummy)
5
Zesstrad59c3892019-11-28 20:53:39 +01006BESCHREIBUNG
7 Wenn die Funktion mit einem String als Argument aufgerufen wird,
8 werden nur Objekte getracet, deren Name mit diesem String
9 uebereinstimmt. Der String <prefix> darf am Anfang keinen "/"
10 enthalten, weil Objektnamen intern ohne diesen "/" am Anfang
11 gespeichert werden. Wird traceprefix() mit einer Zahl als Argument
12 aufgerufen, wird traceprefix ignoriert und alle Objekte werden
13 getracet.
MG Mud User88f12472016-06-24 23:31:02 +020014
Zesstrad59c3892019-11-28 20:53:39 +010015 Die Funktion liefert das alte Praefix zurueck oder 0, wenn keines
16 gefunden wurde.
17
18 Die Master-Lfun valid_trace() wird mit ("traceprefix", prefix)
19 aufgerufen, um die Erlaubnis fuer die Benutzung dieser Funktion zu
20 erhalten.
21
22BEISPIELE
MG Mud User88f12472016-06-24 23:31:02 +020023 object obj;
24 string prefix;
Zesstrad59c3892019-11-28 20:53:39 +010025 obj=find_player("thomas");
26 prefix = object_name(obj); /* z.B. /std/player#69 */
27 prefix = prefix[1..]; /* entfernt den fuehrenden "/" */
MG Mud User88f12472016-06-24 23:31:02 +020028 traceprefix(prefix);
Zesstrad59c3892019-11-28 20:53:39 +010029 /* Von hier an wird nur Code im Objekt std/player#69 getracet */
30 trace(TRACE_CALL|TRACE_CALL_OTHER|TRACE_RETURN|TRACE_ARGS);
MG Mud User88f12472016-06-24 23:31:02 +020031 ...
Zesstrad59c3892019-11-28 20:53:39 +010032 trace(TRACE_NOTHING);
33
34GESCHICHTE
35 Ab LDMud 3.2.9 wird das Argument <prefix> an valid_trace() uebergeben.
36
37SIEHE AUCH
MG Mud User88f12472016-06-24 23:31:02 +020038 trace(E)