blob: 824c7a6afd56a1bd58a73540acb8e4ebff4b2d76 [file] [log] [blame]
Zesstra953f9972017-02-18 15:37:36 +01001find_player()
2*************
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 object find_player(string uid)
MG Mud User88f12472016-06-24 23:31:02 +02009
MG Mud User88f12472016-06-24 23:31:02 +020010
Zesstra953f9972017-02-18 15:37:36 +010011BESCHREIBUNG
12============
MG Mud User88f12472016-06-24 23:31:02 +020013
Zesstra953f9972017-02-18 15:37:36 +010014 Findet den Spieler mit dem Namen bzw. der User-ID <uid>.
MG Mud User88f12472016-06-24 23:31:02 +020015
MG Mud User88f12472016-06-24 23:31:02 +020016
MG Mud User88f12472016-06-24 23:31:02 +020017
Zesstra953f9972017-02-18 15:37:36 +010018 Akzeptiert auch die UUID statt einer UID. In diesem Fall erfolgt aber
19 nur eine Pruefung, ob die UID des gefundenen Spielers zur angegebenen
20 UUID passt (d.h. "jof_-1" wuerde dann ggf. auch das Spielerobjekt Jof
21 zurueckliefern, wenn das die UUID "Jof_1234" hat).
MG Mud User88f12472016-06-24 23:31:02 +020022
Zesstra953f9972017-02-18 15:37:36 +010023 Rueckgabewert ist das Spielerobjekt (wenn Spieler anwesend),
24 ansonsten 0.
25
26
27BEISPIEL
28========
29
30 object ob;
31 ob = find_player("deepthought");
32
33 if(ob)
34 tell_object(ob,"Tach Du!\n");
35
36 oder auch
37
38 if(ob = find_player("deepthought"))
39 tell_object(ob,"Tach Du!\n");
40
41
42ANMERKUNGEN
43===========
44
45 Via find_player() werden auch unsichtbare Magier gefunden. In
46 Objekten, die fuer Spieler gedacht sind, muss dies dann extra
47 per Abfrage auf if(ob->QueryProp(P_INVIS)) getestet werden.
48
49 Netztote Spieler und Monster werden nicht gefunden da find_player
50 den Namen aus set_living_name() verwendet, der in player.c ge-
51 setzt wird.
52
53
54SIEHE AUCH
55==========
56
57 find_living(E), set_living_name(E), find_object(E), find_netdead(E)
58
59Letzte Aenderung: 06.01.2009, Zesstra