MG Mud User | 88f1247 | 2016-06-24 23:31:02 +0200 | [diff] [blame^] | 1 | QueryWizardsForUID() |
| 2 | |
| 3 | FUNKTION: |
| 4 | varargs string* QueryWizardsForUID(string uid, int recursive); |
| 5 | |
| 6 | DEFINIERT IN: |
| 7 | /secure/master/userinfo.c |
| 8 | |
| 9 | ARGUMENTE: |
| 10 | uid |
| 11 | Die UID, fuer die man die Magier ermitteln will, die fuer sie |
| 12 | zustaendig sind. |
| 13 | recursive (optional) |
| 14 | gibt an, ob das QueryWizardsForUID() (indirekt) aus einem |
| 15 | QueryWizardsForUID() heraus gerufen wurde. Sollte nicht manuell gesetzt |
| 16 | werden. |
| 17 | |
| 18 | BESCHREIBUNG: |
| 19 | Die Funktion ermittelt die Magier, die fuer diese UID zustaendig sind. |
| 20 | |
| 21 | RUeCKGABEWERT: |
| 22 | Zurueckgeliefert wird ein Array von Strings, jedes Element ist ein Magier. |
| 23 | Sollte fuer eine UID kein Magier ermittelbar sein, ist das Array leer. |
| 24 | Wenn z.B. fuer die UID der Magier "Atamur" gefunden wird, aber fuer alle |
| 25 | UIDs von "Atamur" auch der Magier "Rumata" zustaendig sein sollte, wird |
| 26 | "Rumata" ueber eine rekursive Suche gefunden. |
| 27 | |
| 28 | BEMERKUNGEN: |
| 29 | Wenn die UID den Magier nicht implizit enthaelt (z.B. GUILD.gilde, im |
| 30 | Gegensatz zu d.region.magier), findet diese Funktion nur Magier, fuer die |
| 31 | seit Laden des Master bereits einmal get_userinfo() oder |
| 32 | QueryUIDsForWizard() im Master gerufen wurde, was z.B. Einloggen passiert. |
| 33 | Magier, die lang nicht einloggten, werden also manchmal nicht gefunden, |
| 34 | was in der Regel nicht schlimm sein sollte, da sie ja ohnehin den |
| 35 | entsprechenden Code gerade nicht warten... |
| 36 | |
| 37 | BEISPIELE: |
| 38 | string *wiz = master()->QueryWizards("GUILD.klerus"); |
| 39 | // wiz enthaelt nun: ({"morgoth","magdalena"}) |
| 40 | |
| 41 | SIEHE AUCH: |
| 42 | QueryUIDsForWizard(), |
| 43 | AddWizardForUID(), RemoveWizardFromUID() |
| 44 | |
| 45 | 16.12.2007, Zesstra |
| 46 | |