blob: 0f18ab537cc0a525dc2bd4618f5d521251fc8a55 [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
5 void tell_room(string|object obj, mixed *|mapping|struct|object msg)
Zesstrab6ac9f62020-01-21 11:11:16 +01006 void tell_room(string|object obj, mixed *|mapping|struct|object msg,
7 object *exclude)
MG Mud User88f12472016-06-24 23:31:02 +02008
Zesstrab6ac9f62020-01-21 11:11:16 +01009BESCHREIBUNG
MG Mud User88f12472016-06-24 23:31:02 +020010 Gibt einen Text <str> an den Raum <obj> aus. <obj> kann auch der
Zesstrab6ac9f62020-01-21 11:11:16 +010011 Name des Raumes als String sein. Wenn das Objekt, das die Meldung
12 erhaelt, nicht ein interaktives Objekt (also kein User) ist, wird
13 im Empfaenger die Funktion catch_tell() mit dem Text als Argument
14 aufgerufen. Falls ein Lebewesen die Funktion catch_tell() definiert,
15 wird der Text hier ausgewertet und nicht an den User ausgegeben.
16 Wenn das Empfaengerobjekt mit seinem Namen angegeben ist, sucht der
17 Driver das Objekt unter diesem Namen und laedt es, falls notwendig.
18 Wenn das Array <*exclude> angegeben ist, wird der Text an die
19 Objekte in <*exclude> nicht ausgegeben.
MG Mud User88f12472016-06-24 23:31:02 +020020
Zesstrab6ac9f62020-01-21 11:11:16 +010021 Wenn das zweite Argument ein nicht-String ist, wird in allen
22 Lebewesen, die den Text erhalten, catch_msg() aufgerufen (statt
23 catch_tell()).
MG Mud User88f12472016-06-24 23:31:02 +020024
Zesstrab6ac9f62020-01-21 11:11:16 +010025BEISPIELE
26 An alle Lebewesen im Raum soll ein simples "Hi!" gesendet werden:
MG Mud User88f12472016-06-24 23:31:02 +020027
Zesstrab6ac9f62020-01-21 11:11:16 +010028 tell_object(environment(this_player()), "Hi!\n");
MG Mud User88f12472016-06-24 23:31:02 +020029
Zesstrab6ac9f62020-01-21 11:11:16 +010030 Folgendes Beispiel zeigt, wie tell_room() zusammen mit catch_tell()
31 funktioniert.
MG Mud User88f12472016-06-24 23:31:02 +020032
Zesstrab6ac9f62020-01-21 11:11:16 +010033 Objekt1 (ein Lebewesen):
MG Mud User88f12472016-06-24 23:31:02 +020034 void catch_tell(string str) {
35 write("Empfangen: "+str+"\n");
36 }
37
38 Objekt2:
39 void fun() {
40 tell_room(environment(this_player()), "Hallo Welt!\n");
41 }
42
Zesstrab6ac9f62020-01-21 11:11:16 +010043GESCHICHTE
44 LDMud 3.3.686 erlaubt die Verwendung eines mapping/struct/object als
45 zweites Argument.
MG Mud User88f12472016-06-24 23:31:02 +020046
Zesstrab6ac9f62020-01-21 11:11:16 +010047SIEHE AUCH
48 write(E), say(E), tell_object(E), catch_tell(A), catch_msg(A)