llListenRemove

From Second Life Wiki
Revision as of 18:06, 12 April 2014 by Nelson Jenkins (talk | contribs) (Undo revision 1189390 by Rolig Loon (Talk))
Jump to navigation Jump to search
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

Summary

Function: llListenRemove( integer handle );

Removes listen event callback handle

• integer handle handle to control listen event

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 handle has already been released or is invalid.
All Issues ~ Search JIRA for related Bugs

Examples

<lsl> // Listen for one line of chat from the owner, echo it back to them, then stop listening integer ListenHandle; default {

   state_entry()
   {
       // Start listening on channel 0, for text from owner only
       ListenHandle = llListen(0, "", llGetOwner(), "");
   }
   listen(integer channel, string name, key id, string message)
   {
       llOwnerSay(message);            // Echo the message back to the owner
       llListenRemove(ListenHandle);   // Stop listening
   }
}</lsl>

Notes

  • It is good practice to remove listeners when they are no longer required, or set them inactive via llListenControl

See Also

Events

• listen

Functions

•  llListen
•  llListenControl

Deep Notes

Search JIRA for related Issues

Signature

function void llListenRemove( integer handle );