blob: 6692643c66768a78ebf47aa99bd67976bd105125 [file] [log] [blame]
Zesstrab6ac9f62020-01-21 11:11:16 +01001SYNOPSIS
2 void tell_room(string|object obj, string str)
3 void tell_room(string|object obj, string str, object *exclude)
MG Mud User88f12472016-06-24 23:31:02 +02004
Zesstra5481d492021-04-08 20:07:06 +02005 void tell_room(string|object obj,
6 mixed *|mapping|struct|object|lwobject msg)
7 void tell_room(string|object obj,
8 mixed *|mapping|struct|object|lwobject msg,
9 object *exclude)
MG Mud User88f12472016-06-24 23:31:02 +020010
Zesstrab6ac9f62020-01-21 11:11:16 +010011BESCHREIBUNG
MG Mud User88f12472016-06-24 23:31:02 +020012 Gibt einen Text <str> an den Raum <obj> aus. <obj> kann auch der
Zesstrab6ac9f62020-01-21 11:11:16 +010013 Name des Raumes als String sein. Wenn das Objekt, das die Meldung
14 erhaelt, nicht ein interaktives Objekt (also kein User) ist, wird
15 im Empfaenger die Funktion catch_tell() mit dem Text als Argument
16 aufgerufen. Falls ein Lebewesen die Funktion catch_tell() definiert,
17 wird der Text hier ausgewertet und nicht an den User ausgegeben.
18 Wenn das Empfaengerobjekt mit seinem Namen angegeben ist, sucht der
19 Driver das Objekt unter diesem Namen und laedt es, falls notwendig.
20 Wenn das Array <*exclude> angegeben ist, wird der Text an die
21 Objekte in <*exclude> nicht ausgegeben.
MG Mud User88f12472016-06-24 23:31:02 +020022
Zesstrab6ac9f62020-01-21 11:11:16 +010023 Wenn das zweite Argument ein nicht-String ist, wird in allen
24 Lebewesen, die den Text erhalten, catch_msg() aufgerufen (statt
25 catch_tell()).
MG Mud User88f12472016-06-24 23:31:02 +020026
Zesstrab6ac9f62020-01-21 11:11:16 +010027BEISPIELE
28 An alle Lebewesen im Raum soll ein simples "Hi!" gesendet werden:
MG Mud User88f12472016-06-24 23:31:02 +020029
Zesstrab6ac9f62020-01-21 11:11:16 +010030 tell_object(environment(this_player()), "Hi!\n");
MG Mud User88f12472016-06-24 23:31:02 +020031
Zesstrab6ac9f62020-01-21 11:11:16 +010032 Folgendes Beispiel zeigt, wie tell_room() zusammen mit catch_tell()
33 funktioniert.
MG Mud User88f12472016-06-24 23:31:02 +020034
Zesstrab6ac9f62020-01-21 11:11:16 +010035 Objekt1 (ein Lebewesen):
MG Mud User88f12472016-06-24 23:31:02 +020036 void catch_tell(string str) {
37 write("Empfangen: "+str+"\n");
38 }
39
40 Objekt2:
41 void fun() {
42 tell_room(environment(this_player()), "Hallo Welt!\n");
43 }
44
Zesstrab6ac9f62020-01-21 11:11:16 +010045GESCHICHTE
46 LDMud 3.3.686 erlaubt die Verwendung eines mapping/struct/object als
47 zweites Argument.
MG Mud User88f12472016-06-24 23:31:02 +020048
Zesstrab6ac9f62020-01-21 11:11:16 +010049SIEHE AUCH
50 write(E), say(E), tell_object(E), catch_tell(A), catch_msg(A)