Difference between revisions of "LlListenRemove"

From Second Life Wiki
Jump to: navigation, search
m (<lsl> tag to <source>)
 
(One intermediate revision by one other user not shown)
Line 12: Line 12:
 
*No error is thrown if {{LSLP|handle}} has already been released or is invalid.
 
*No error is thrown if {{LSLP|handle}} has already been released or is invalid.
 
|constants
 
|constants
|examples=<lsl>
+
|examples=<source lang="lsl2">
 
// Listen for one line of chat from the owner, echo it back to them, then stop listening
 
// Listen for one line of chat from the owner, echo it back to them, then stop listening
 
integer ListenHandle;
 
integer ListenHandle;
Line 27: Line 27:
 
         llListenRemove(ListenHandle);  // Stop listening
 
         llListenRemove(ListenHandle);  // Stop listening
 
     }
 
     }
}</lsl>
+
}</source>
 
|helpers
 
|helpers
 
|also_functions={{LSL DefineRow||[[llListen]]}}
 
|also_functions={{LSL DefineRow||[[llListen]]}}
Line 40: Line 40:
 
|cat1=Communications
 
|cat1=Communications
 
|cat2=Chat
 
|cat2=Chat
|haiku={{Haiku|"He's calling me names!"|"Tell him I said ''''stop''''," I say,|"And ''you'' -- don't listen."}}
 
 
|cat3
 
|cat3
 
|cat4
 
|cat4
 
}}
 
}}

Latest revision as of 11:13, 22 January 2015

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

// 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
    }
}

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 );