OsListenRegex
From OpenSimulator
(Difference between revisions)
| Line 6: | Line 6: | ||
|description=Allows the server to filter listen events by regular expressions. name or message parameters can be regular expressions, these are behaviours are controlled via the regexBitField parameter using the constants [[OS_LISTEN_REGEX_NAME]] and [[OS_LISTEN_REGEX_MESSAGE]]. | |description=Allows the server to filter listen events by regular expressions. name or message parameters can be regular expressions, these are behaviours are controlled via the regexBitField parameter using the constants [[OS_LISTEN_REGEX_NAME]] and [[OS_LISTEN_REGEX_MESSAGE]]. | ||
If the regex strings are invalid, an error will be shouted on the debug channel. | If the regex strings are invalid, an error will be shouted on the debug channel. | ||
| + | |ossl_example=<source lang="lsl"> | ||
| + | |||
| + | // | ||
| + | // osListenRegex Script Example | ||
| + | // Source from OpenSimWorld https://github.com/opensimworld/active-npcs | ||
| + | // | ||
| + | |||
| + | string NPCNAME="INVALID"; | ||
| + | integer zListener=-1; | ||
| + | |||
| + | InitListener() | ||
| + | { | ||
| + | |||
| + | key id = llGetOwner(); | ||
| + | if (id) | ||
| + | { | ||
| + | string name= llKey2Name(llGetOwner()); | ||
| + | NPCNAME = llGetSubString(name, 0, llSubStringIndex(name, " ") - 1); | ||
| + | if (zListener <0) | ||
| + | { | ||
| + | zListener = osListenRegex(0, "", "", "^(?i)(hi|hello|"+NPCNAME+" )(?-i)", OS_LISTEN_REGEX_MESSAGE); | ||
| + | llOwnerSay("Listening for '"+NPCNAME+"'"); | ||
| + | } | ||
| + | } | ||
| + | } | ||
| + | |||
| + | |||
| + | default | ||
| + | { | ||
| + | state_entry() | ||
| + | { | ||
| + | llSay( 0, "I am Alive!"); | ||
| + | } | ||
| + | |||
| + | touch_start(integer number_of_touchs) | ||
| + | { | ||
| + | llSay( 0, "Touched."); | ||
| + | InitListener(); | ||
| + | } | ||
| + | } | ||
| + | |||
| + | </source> | ||
|additional_info=This function was added in 0.7.5-post-fixes | |additional_info=This function was added in 0.7.5-post-fixes | ||
}} | }} | ||
Revision as of 02:15, 6 December 2020
 |
Languages: |
|
integer osListenRegex(integer channelID, string name, key ID, string msg, integer regexBitfield)
| |
| Allows the server to filter listen events by regular expressions. name or message parameters can be regular expressions, these are behaviours are controlled via the regexBitField parameter using the constants OS_LISTEN_REGEX_NAME and OS_LISTEN_REGEX_MESSAGE.
If the regex strings are invalid, an error will be shouted on the debug channel. | |
| Threat Level | Low |
| Permissions | Use of this function is always allowed by default |
| Extra Delay | 0 seconds |
| Example(s) | |
// // osListenRegex Script Example // Source from OpenSimWorld https://github.com/opensimworld/active-npcs // string NPCNAME="INVALID"; integer zListener=-1; InitListener() { key id = llGetOwner(); if (id) { string name= llKey2Name(llGetOwner()); NPCNAME = llGetSubString(name, 0, llSubStringIndex(name, " ") - 1); if (zListener <0) { zListener = osListenRegex(0, "", "", "^(?i)(hi|hello|"+NPCNAME+" )(?-i)", OS_LISTEN_REGEX_MESSAGE); llOwnerSay("Listening for '"+NPCNAME+"'"); } } } default { state_entry() { llSay( 0, "I am Alive!"); } touch_start(integer number_of_touchs) { llSay( 0, "Touched."); InitListener(); } } | |
| Notes | |
| This function was added in 0.7.5-post-fixes | |
