| Zesstra | 1862697 | 2017-01-31 10:38:27 +0100 | [diff] [blame] | 1 | QueryWizardsForUID() |
| 2 | ==================== |
| 3 | |
| 4 | FUNKTION |
| 5 | -------- |
| 6 | :: |
| 7 | |
| 8 | varargs string* QueryWizardsForUID(string uid, int recursive); |
| 9 | |
| 10 | DEFINIERT IN |
| 11 | ------------ |
| 12 | :: |
| 13 | |
| 14 | /secure/master/userinfo.c |
| 15 | |
| 16 | ARGUMENTE |
| 17 | --------- |
| 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 | BESCHREIBUNG |
| 29 | ------------ |
| 30 | :: |
| 31 | |
| 32 | Die Funktion ermittelt die Magier, die fuer diese UID zustaendig sind. |
| 33 | |
| 34 | RUeCKGABEWERT |
| 35 | ------------- |
| 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 | BEMERKUNGEN |
| 45 | ----------- |
| 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 | BEISPIELE |
| 57 | --------- |
| 58 | :: |
| 59 | |
| 60 | string *wiz = master()->QueryWizards("GUILD.klerus"); |
| 61 | // wiz enthaelt nun: ({"morgoth","magdalena"}) |
| 62 | |
| 63 | SIEHE AUCH |
| 64 | ---------- |
| 65 | :: |
| 66 | |
| 67 | QueryUIDsForWizard(), |
| 68 | AddWizardForUID(), RemoveWizardFromUID() |
| 69 | |
| 70 | 16.12.2007, Zesstra |
| 71 | |