Difference between revisions of "LlListenRemove"

From Second Life Wiki
Jump to navigation Jump to search
m (corrected minor typo: automaticaly)
m (didn't like the param name)
Line 1: Line 1:
{{LSL_Function
{{LSL_Function
|func_id=27|func_sleep=0.0|func_energy=10.0
|func_id=27|func_sleep=0.0|func_energy=10.0
|func=llListenRemove|p1_type=integer|p1_name=number
|func=llListenRemove|p1_type=integer|p1_name=handle
|func_footnote
|func_footnote
|func_desc=Removes listen event callback '''number'''
|func_desc=Removes listen event callback {{LSLP|handle}}
|return_text
|return_text
|spec
|spec
|caveats=*On [[state]] change or [[llResetScript|script reset]] all listens are removed automatically.
|caveats=*On [[state]] change or [[llResetScript|script reset]] all listens are removed automatically.
**A state change can be used as a shortcut to releasing all listens in the script.
**A state change can be used as a shortcut to releasing all listens in the script.
*No error is thrown if '''number''' has already been released or is invalid.
*No error is thrown if {{LSLP|number}} has already been released or is invalid.
|constants
|constants
|examples=<lsl>integer olf;
|examples=<lsl>integer olf;

Revision as of 11:19, 29 June 2012

Summary

Function: llListenRemove( integer handle );

Removes listen event callback handle

• integer handle

Caveats

  • On state change or script reset all listens are removed automatically.
    • A state change can be used as a shortcut to releasing all listens in the script.
  • No error is thrown if number has already been released or is invalid.
All Issues ~ Search JIRA for related Bugs

Examples

<lsl>integer olf; default {

   //Repeats one line of text then stops listening
   state_entry()
   {
       olf = llListen(0, "", llGetOwner(), "");
   }
   listen(integer channel, string name, key id, string message)
   {
       llOwnerSay(message);
       llListenRemove(olf);
   }
}</lsl>

See Also

Events

• listen

Functions

•  llListen
•  llListenControl

Deep Notes

Search JIRA for related Issues

Signature

function void llListenRemove( integer handle );