blob: 2ea70221b685d4d138d61b90cef3bd817585629a [file] [log] [blame]
MG Mud User88f12472016-06-24 23:31:02 +02001QueryWizardsForUID()
Zesstra953f9972017-02-18 15:37:36 +01002********************
MG Mud User88f12472016-06-24 23:31:02 +02003
MG Mud User88f12472016-06-24 23:31:02 +02004
Zesstra953f9972017-02-18 15:37:36 +01005FUNKTION
6========
MG Mud User88f12472016-06-24 23:31:02 +02007
Zesstra953f9972017-02-18 15:37:36 +01008 varargs string* QueryWizardsForUID(string uid, int recursive);
MG Mud User88f12472016-06-24 23:31:02 +02009
MG Mud User88f12472016-06-24 23:31:02 +020010
Zesstra953f9972017-02-18 15:37:36 +010011DEFINIERT IN
12============
MG Mud User88f12472016-06-24 23:31:02 +020013
Zesstra953f9972017-02-18 15:37:36 +010014 /secure/master/userinfo.c
MG Mud User88f12472016-06-24 23:31:02 +020015
MG Mud User88f12472016-06-24 23:31:02 +020016
Zesstra953f9972017-02-18 15:37:36 +010017ARGUMENTE
18=========
19
20 uid
21 Die UID, fuer die man die Magier ermitteln will, die fuer sie
22 zustaendig sind.
23 recursive (optional)
24 gibt an, ob das QueryWizardsForUID() (indirekt) aus einem
25 QueryWizardsForUID() heraus gerufen wurde. Sollte nicht manuell gesetzt
26 werden.
27
28
29BESCHREIBUNG
30============
31
32 Die Funktion ermittelt die Magier, die fuer diese UID zustaendig sind.
33
34
35RUeCKGABEWERT
36=============
37
38 Zurueckgeliefert wird ein Array von Strings, jedes Element ist ein Magier.
39 Sollte fuer eine UID kein Magier ermittelbar sein, ist das Array leer.
40 Wenn z.B. fuer die UID der Magier "Atamur" gefunden wird, aber fuer alle
41 UIDs von "Atamur" auch der Magier "Rumata" zustaendig sein sollte, wird
42 "Rumata" ueber eine rekursive Suche gefunden.
43
44
45BEMERKUNGEN
46===========
47
48 Wenn die UID den Magier nicht implizit enthaelt (z.B. GUILD.gilde, im
49 Gegensatz zu d.region.magier), findet diese Funktion nur Magier, fuer die
50 seit Laden des Master bereits einmal get_userinfo() oder
51 QueryUIDsForWizard() im Master gerufen wurde, was z.B. Einloggen passiert.
52 Magier, die lang nicht einloggten, werden also manchmal nicht gefunden,
53 was in der Regel nicht schlimm sein sollte, da sie ja ohnehin den
54 entsprechenden Code gerade nicht warten...
55
56
57BEISPIELE
58=========
59
60 string *wiz = master()->QueryWizards("GUILD.klerus");
61 // wiz enthaelt nun: ({"morgoth","magdalena"})
62
63
64SIEHE AUCH
65==========
66
67 QueryUIDsForWizard(),
68 AddWizardForUID(), RemoveWizardFromUID()
MG Mud User88f12472016-06-24 23:31:02 +020069
7016.12.2007, Zesstra