Difference between revisions of "LlListenRemove"
From Second Life Wiki
(Undo revision 1189390 by Rolig Loon (Talk)) |
m (<lsl> tag to <source>) |
||
| 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=< | + | |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 | ||
} | } | ||
| − | }</ | + | }</source> |
|helpers | |helpers | ||
|also_functions={{LSL DefineRow||[[llListen]]}} | |also_functions={{LSL DefineRow||[[llListen]]}} | ||
Latest revision as of 11:13, 22 January 2015
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
Summary
Function: llListenRemove( integer handle );| 27 | Function ID |
| 0.0 | Forced Delay |
| 10.0 | Energy |
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.
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
