Difference between revisions of "LlListen"

Revision as of 02:15, 26 February 2007

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.

On state change, all listens are removed automatically. It is a feature.
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 );

@@ Line 9: / Line 9: @@
 |func_footnote=If '''msg''', '''name''' or '''id''' are blank there are not used to filter incoming messages.<br/>
 If '''id''' is an invalid key or a {{LSLG|NULL_KEY|null key}}, it is considered blank.
-|also_functions={{LSL DefineRow||{{LSLG|llListenRemove}}|}}
+|also_functions={{LSL DefineRow||{{LSLG|llListenRemove}}|Removes a listen}}
-{{LSL DefineRow||{{LSLG|llListenControl}}|}}
+{{LSL DefineRow||{{LSLG|llListenControl}}|Enables/Disables a listen}}
-{{LSL DefineRow||{{LSLG|llWhisper}}|}}
+{{LSL DefineRow||{{LSLG|llWhisper}}|Sends chat limited to 10 meters}}
-{{LSL DefineRow||{{LSLG|llSay}}|}}
+{{LSL DefineRow||{{LSLG|llSay}}|Sends chat limited to 20 meters}}
-{{LSL DefineRow||{{LSLG|llShout}}|}}
+{{LSL DefineRow||{{LSLG|llShout}}|Sends chat limited to 100 meters}}
 |also_events={{LSL DefineRow||{{LSLG|listen}}|}}
 |also_tests
@@ Line 20: / Line 20: @@
 |constants
 |caveats=*On [[state]] change, all listens are removed automatically. It is a feature.
+*Only 64 listens can simultaneously be open in any single script.
+**If this number is exceeded an error is shouted.
 |specs
 |cat1=Communications