llFindNotecardTextSync

Template:Needs Translation/LSL/de Template:Needs Translation/LSL/es Template:Needs Translation/LSL/el Template:Needs Translation/LSL/fr Template:Needs Translation/LSL/he Template:Needs Translation/LSL/it Template:Needs Translation/LSL/ja Template:Needs Translation/LSL/ko Template:Needs Translation/LSL/nl Template:Needs Translation/LSL/hu Template:Needs Translation/LSL/no Template:Needs Translation/LSL/da Template:Needs Translation/LSL/sv Template:Needs Translation/LSL/tr Template:Needs Translation/LSL/pl Template:Needs Translation/LSL/pt Template:Needs Translation/LSL/ru Template:Needs Translation/LSL/th Template:Needs Translation/LSL/uk Template:Needs Translation/LSL/zh-Hans Template:Needs Translation/LSL/zh-Hant

/LSL

FindNotecardTextSync

llFindNotecardTextSync

Summary

Function: list llFindNotecardTextSync( string name, string pattern, integer start, integer count, list options );

0.0	Forced Delay
10.0	Energy

Returns a list of lines and columns where the search pattern is found in the notecard.
Returns the list containing a list of integers containing the locations of the found text.

• string	name	–	a notecard in the inventory of the prim this script is in or a UUID of a notecard
• string	pattern	–	The regex pattern to search for
• integer	start	–	The first line in the notecard to start the search
• integer	count	–	The maximum number of search results to return
• list	options	–	A list of options to pass into the search. (unused at this time, should be [])

line does not support negative indexes. Returns a list containing only NAK if the notecard is not cached.

Specification

Searches the text of a cached notecard for lines containing the given pattern. It returns a list of any found occurrences of pattern in the notecard. If the notecard is not in the cache it returns a list containing a single entry of NAK. If no matches are found, or the notecard contains embedded items, an empty list is returned.

Every match in the notecard is represented as a sequence of three integers [the row #, the column #, the length of the match]. In other words the returned list has a stride of 3.

If the notecard does not exist it returns a list with a single NAK constant and will shout a message to the debug channel. If the notecard has not been previously cached on the simulator it will return a list containing NAK.

If there is an error in the regular expression this function returns an empty list and shouts a message to the debug channel.

Notecards are cached into a fixed-size buffer, with the oldest (least-recently read) notecard getting removed first. It is not safe to assume a notecard has been previously cached. Data for a previously cached notecard may be dropped from the cache at any time, especially on a busy server.

Caveats

• If line is out of bounds the script continues to execute without an error message.
• If name is missing from the prim's inventory and it is not a UUID or it is not a notecard then an error is shouted on DEBUG_CHANNEL.
• If name is a UUID then there are no new asset permissions consequences for the object.
  • The resulting object develops no new usage restrictions that might have occurred if the asset had been placed in the prims inventory.
• If name is a new empty notecard (never saved) then an error "Couldn't find notecard ~NAME~" (~NAME~ being the value of name) will be shouted on the DEBUG_CHANNEL. This is because until a notecard is saved for the first time, it does not exist as an asset only as an inventory placeholder.
  • If the notecard is full-perms you can check for this with llGetInventoryKey which will return NULL_KEY in this case. However if notecard is not full-perms, there is no way to avoid the error message.
• If notecard contains embedded inventory items (such as textures and landmarks), an empty list will be returned, regardless of the search string.
• Unlike llLinksetDataFindKeys, this function has no count parameter, meaning it will always return all possible matches. Make sure your script has lots of free memory available to avoid stack-heap collision errors.

Examples

Notes

Regular Expression Cheat Sheet

Wildcard
.	Matches any character
Anchors
^	Matches the beginning of the string.
$	Matches the end of the string.
Expression Prefixes
(?i)	Makes search string case insensitive.	This must be the first thing that appears in the search string. "(?i)apple" will match "apple", "APPLE", "ApPlE", and any other combination of upper and lower case characters.
$	Matches the end of the string.
Repeats
*	Matches the preceding atom 0 or more times.
+	Matches the preceding atom 1 or more times.
?	Matches the preceding atom 0 or 1 times.
{n} {n,} {n, m}	Matches the preceding atom n, n or more, or between n and m times.
Sub-expressions
(expression)	Text enclosed in parentheses is a marked sub-expression. Text matched as part of a sub-expressions is split out and may be repeated.
Alternation
a | b	Match either a or b.
Character Sets
[abc]	Matches any one of the enumerated characters.
[a-c]	Matches any character in the specified range.
[^abc]	Matches any character other than the enumerated characters.
[[:name:]]	Matches any character of the named class.
	Any of the above character set definitions may be combined.
Escape Sequences
	Specific Characters
\e	ASCII 0x1B, ESC
\n	New line
\r	Carriage return
\t	Tab
\xdd	Matches an ASCII character with the code dd
	Single character classes
\d \D	Any decimal digit.	\d → [[:digit:]] or [0-9] \D → [^[:digit:]] or [^0-9]
\l \L	Any lower case character.	\l → [[:lower:]] or [a-z] \L → [^[:lower:]] or [^a-z]
\s \S	Any whitespace character.	\s → [[:space:]] or [ \t\r\n] \S → [^[:space:]] or [^ \t\r\n]
\u \U	Any upper case character.	\u → [[:upper:]] or [A-Z] \U → [^[:upper:]] or [^A-Z]
\w \W	Any "word" character. Alphanumeric plus underscore	\w → [[:upper:][:lower:][:digit:]_] or [A-Za-z0-9_] \W → [^[:upper:][:lower:][:digit:]_] or [^A-Za-z0-9_]
	Word boundaries
\<	Start of word.
\>	End of word
\b
\B	Not a word boundary.
*Note* LSL uses '\' as an escape character in strings. The escape characters above must be double escaped. So "\d" needs to be written in LSL as "\\d" Please see LSL Strings, Escape Codes
Named Character Classes
alnum	Any alpha-numeric character.	[[:alnum:]] → [0-9a-zA-Z] [^[:alnum:]] → [^0-9a-zA-Z]
alpha	Any alphabetic character.	[[:alpha:]] → [a-zA-Z] [^[:alpha:]] → [^a-zA-Z]
blank	Any whitespace character that is not a line separator.
cntrl	Any control character	[[:cntrl:]] → [\x01-\x31] [^[:cntrl:]] → [^\x01-\x31]
digit d	Any decimal digit	[[:digit:]] → [0-9] [^[:digit:]] → [^0-9]
lower l	Any lower case character.	[[:lower:]] → [a-z] [^[:lower:]] → [^a-z]
print	Any printable character.
punct	Any punctiation character.
space s	Any whitespace character.
upper u	Any upper case character.	[[:upper:]] → [A-Z] [^[:upper:]] → [^A-Z]
word w	Any control character	[[:word:]] → [0-9a-zA-Z_] [^[:word:]] → [^0-9a-zA-Z_]
xdigit	Any hexadecimal digit character	[[:xdigit:]] → [0-9a-fA-F] [^[:xdigit:]] → [^0-9a-fA-F]

See Also

Functions

•	llGetNumberOfNotecardLines
•	llGetNotecardLine

Deep Notes

Signature
function list llFindNotecardTextSync( string name, string pattern, integer start, integer count, list options );