llListen

Function: integer llListen( integer channel, string name, key id, string msg );

Sets a callback for msg on channel from name and id.
Returns an integer that can be used to deactivate or remove the listen.

• integer	channel	–	any valid integer, positive or negative.
• string	name
• key	id
• string	msg

If msg, name or id are blank there are not used to filter incoming messages.
If id is an invalid key or a null key, it is considered blank.

Lag tip: Avoid channel 0 and set name or id where possible. llListen(0,"",NULL_KEY,"") is extremely laggy and should be avoided at all cost.

Channel Constant		Description
DEBUG_CHANNEL	0x7FFFFFFF	Chat channel reserved for script debugging and error messages, broadcasts to all nearby users.
PUBLIC_CHANNEL	0x0	Chat channel that broadcasts to all nearby users. This channel is sometimes referred to as: open chat, local chat and public chat.

Caveats

On state change or script reset all listens are released.
- A state change can be used as a shortcut to releasing listens.
Only 64 listens can simultaneously be open in any single script.
- If this number is exceeded an error is shouted.

Signature
function integer llListen( integer channel, string name, key id, string msg );