/doc/efun/tell_room

SYNOPSIS

void tell_room(object ob, string str)
void tell_room(object ob, string str, object *exclude)
void tell_room(object ob, mixed *msg)
void tell_room(object ob, mixed *msg, object *exclude)

DESCRIPTION

Send a message str to all living objects in the room ob. ob can also be the name of the room given as a string. If a receiving object is not a interactive user the lfun catch_tell() of the object will be invoked with the message as argument. If living objects define catch_tell(), the string will also be sent to that instead of being written to the user.

If array *exclude is given, all objects contained in *exclude are excluded from the message str.

If the second arg is an array, catch_msg() will be called in all listening livings.

EXAMPLE

tell_object(environment(this_player()), "Hi!\n"); Just send a simple "Hi!" to all livings in the current. Object 1 (living)

	   void catch_tell(string str) {
	      write("Received: "+str+"\n");
	   }
	Object 2
	   void func() {
	      ...
	      tell_room(environment(this_player()), "HiHo!\n");
	      ...
	   }

This examples shows how tell_room() together with catch_tell() works.

SEE ALSO

write

shout

say

tell_object

catch_msg

| Home | Applied | Concepts | Efuns | Help | Intro | Lib | LPC | Prop | Obj | Sefuns | Std | W |