Difference between revisions of "LlListenRemove"
Jump to navigation
Jump to search
All Issues ~ Search JIRA for related Bugs
m (Replaced <source> with <syntaxhighlight>) |
m (Added haiku generated by the Poem Generated and slightly tweaked) |
||
Line 42: | Line 42: | ||
|cat3 | |cat3 | ||
|cat4 | |cat4 | ||
|haiku|{{Haiku|Wee break of the day|A good listener removed|out of primitive}} | |||
}} | }} |
Revision as of 05:33, 23 April 2022
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