Difference between revisions of "LlListenRemove"
Jump to navigation
Jump to search
All Issues ~ Search JIRA for related Bugs
Omei Qunhua (talk | contribs) (Better variable name. Improve comments) |
m |
||
Line 2: | Line 2: | ||
|inject-2={{LSL Function/handle|handle|listen}} | |inject-2={{LSL Function/handle|handle|listen}} | ||
|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=handle | |func=llListenRemove | ||
|p1_type=integer|p1_subtype=handle|p1_name=handle | |||
|func_footnote | |func_footnote | ||
|func_desc=Removes listen event callback {{LSLP|handle}} | |func_desc=Removes listen event callback {{LSLP|handle}} |
Revision as of 12:56, 30 December 2013
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
<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