LlFindNotecardTextSync - Revision history

Madi Melodious: added llGetNotecardLineSync to the function lists

2025-05-25T19:42:56Z

added llGetNotecardLineSync to the function lists

← Older revision		Revision as of 12:42, 25 May 2025
Line 33:		Line 33:
	\|also_functions={{LSL DefineRow\|\|[[llGetNumberOfNotecardLines]]\|}}		\|also_functions={{LSL DefineRow\|\|[[llGetNumberOfNotecardLines]]\|}}
	{{LSL DefineRow\|\|[[llGetNotecardLine]]\|}}		{{LSL DefineRow\|\|[[llGetNotecardLine]]\|}}
			{{LSL DefineRow\|\|[[llGetNotecardLineSync]]\|}}
	\|also_events		\|also_events
	\|also_articles		\|also_articles

Wulfie Reanimator: Wording, formatting

2024-11-16T13:38:27Z

Wording, formatting

← Older revision		Revision as of 06:38, 16 November 2024
Line 14:		Line 14:
	\|func_footnote=Returns a list containing only [[NAK]] if the notecard is not cached.		\|func_footnote=Returns a list containing only [[NAK]] if the notecard is not cached.
	\|spec=		\|spec=
	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		Searches the text of a cached notecard for lines containing the given pattern. If the notecard is not in the cache, returns a list containing a single [[NAK]], otherwise a list of matches of the pattern in the notecard. If no matches are found, or the notecard contains embedded items, an empty list is returned.
	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.		Every match in the notecard is represented as a sequence of three integers:
			<syntaxhighlight lang="lsl2">[integer row, integer column, integer length]</syntaxhighlight>
			In other words the returned list has a stride of 3. A maximum of 64 matches are returned, resulting in a maximum list length of 192.

	~~A maximum of 64 matches are returned resulting in~~ a ~~maximum~~ list ~~length of 192~~.		If the notecard does not exist, returns a list containing a single [[NAK]] and the script will shout an error on [[DEBUG_CHANNEL]] (but the script continues to run).

	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, returns an empty list and the script will shout an error on [[DEBUG_CHANNEL]] (but the script continues to run).

	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.		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 notecard contains embedded inventory items (such as textures and landmarks), an empty list will be returned, regardless of the search string.		\|caveats=
			* If notecard contains embedded inventory items (such as textures and landmarks), an empty list will be returned, regardless of the search string.
			* No more than 64 matches are returned.
	\|constants		\|constants
	\|examples		\|examples

Lucia Nightfire: Removed 'line' references from previous sourced wiki page. Added mention of max 64 matches returned.

2024-09-06T00:02:43Z

Removed 'line' references from previous sourced wiki page. Added mention of max 64 matches returned.

← Older revision		Revision as of 17:02, 5 September 2024
Line 1:		Line 1:
	{{LSL_Function		{{LSL_Function
	\|inject-2=~~{{LSL_Function/negative_index\|false\|line}}~~{{LSL_Function/notecard\|name\|uuid=true}}		\|inject-2={{LSL_Function/notecard\|name\|uuid=true}}
	\|func_id=\|func_sleep=0.0\|func_energy=10.0		\|func_id=\|func_sleep=0.0\|func_energy=10.0
	\|sort=FindNotecardTextSync		\|sort=FindNotecardTextSync
Line 18:		Line 18:

	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.		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.

			A maximum of 64 matches are returned resulting in a maximum list length of 192.

	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 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]].

Rider Linden at 16:27, 31 July 2024

2024-07-31T16:27:58Z

← Older revision		Revision as of 09:27, 31 July 2024
Line 7:		Line 7:
	\|p1_type=string\|p1_name=name		\|p1_type=string\|p1_name=name
	\|p2_type=string\|p2_name=pattern\|p2_desc=The regex pattern to search for		\|p2_type=string\|p2_name=pattern\|p2_desc=The regex pattern to search for
	\|p3_type=integer\|p3_name=start\|p3_desc=The ~~first line in the notecard~~ to ~~start~~ the ~~search~~		\|p3_type=integer\|p3_name=start\|p3_desc=The number of match results to skip before returning matches. 0 will begin at the first match.
	\|p4_type=integer\|p4_name=count\|p4_desc=The maximum number of search results to return		\|p4_type=integer\|p4_name=count\|p4_desc=The maximum number of search results to return
	\|p5_type=list\|p5_name=options\|p5_desc=A list of options to pass into the search. (unused at this time, should be [])		\|p5_type=list\|p5_name=options\|p5_desc=A list of options to pass into the search. (unused at this time, should be [])

Rhet0rica Resident: removed obsolete warning about large return data (that was fast!)

2024-07-03T21:20:01Z

removed obsolete warning about large return data (that was fast!)

← Older revision		Revision as of 14:20, 3 July 2024
Line 26:		Line 26:

	\|caveats=* If notecard contains embedded inventory items (such as textures and landmarks), an empty list will be returned, regardless of the search string.		\|caveats=* 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.
	\|constants		\|constants
	\|examples		\|examples

Rider Linden at 20:28, 3 July 2024

2024-07-03T20:28:11Z

← Older revision		Revision as of 13:28, 3 July 2024
Line 7:		Line 7:
	\|p1_type=string\|p1_name=name		\|p1_type=string\|p1_name=name
	\|p2_type=string\|p2_name=pattern\|p2_desc=The regex pattern to search for		\|p2_type=string\|p2_name=pattern\|p2_desc=The regex pattern to search for
			\|p3_type=integer\|p3_name=start\|p3_desc=The first line in the notecard to start the search
			\|p4_type=integer\|p4_name=count\|p4_desc=The maximum number of search results to return
			\|p5_type=list\|p5_name=options\|p5_desc=A list of options to pass into the search. (unused at this time, should be [])
	\|func_desc=Returns a list of lines and columns where the search pattern is found in the notecard.		\|func_desc=Returns a list of lines and columns where the search pattern is found in the notecard.
	\|Return_text=containing a list of integers containing the locations of the found text.		\|Return_text=containing a list of integers containing the locations of the found text.
	\|func_footnote=Returns [[NAK]] if the notecard is not cached.		\|func_footnote=Returns a list containing only [[NAK]] if the notecard is not cached.
	\|spec=		\|spec=
	Searches the text of a cached notecard for lines containing the given pattern. It returns a list of ~~line numbers and column where a match is~~ found. If the notecard is not in		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.		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 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.		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.

Rhet0rica Resident: Added caveat about large return data

2024-07-03T20:27:44Z

Added caveat about large return data

← Older revision		Revision as of 13:27, 3 July 2024
Line 19:		Line 19:

	\|caveats=* If notecard contains embedded inventory items (such as textures and landmarks), an empty list will be returned, regardless of the search string.		\|caveats=* 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.
	\|constants		\|constants
	\|examples		\|examples
Line 30:		Line 31:
	{{LSL Regular Expressions}}		{{LSL Regular Expressions}}
	\|cat1=Notecard		\|cat1=Notecard
	\|cat2=~~LSL~~		\|cat2=
	\|cat3=		\|cat3=
	\|cat4=		\|cat4=
	\|history=		\|history=
	}}		}}

Rider Linden: Created page with "{{LSL_Function |inject-2={{LSL_Function/negative_index|false|line}}{{LSL_Function/notecard|name|uuid=true}} |func_id=|func_sleep=0.0|func_energy=10.0 |sort=FindNotecardTextSyn..."

2024-07-01T18:29:47Z

Created page with "{{LSL_Function |inject-2={{LSL_Function/negative_index|false|line}}{{LSL_Function/notecard|name|uuid=true}} |func_id=|func_sleep=0.0|func_energy=10.0 |sort=FindNotecardTextSyn..."

New page

{{LSL_Function
|inject-2={{LSL_Function/negative_index|false|line}}{{LSL_Function/notecard|name|uuid=true}}
|func_id=|func_sleep=0.0|func_energy=10.0
|sort=FindNotecardTextSync
|func=llFindNotecardTextSync
|return_type=list
|p1_type=string|p1_name=name
|p2_type=string|p2_name=pattern|p2_desc=The regex pattern to search for
|func_desc=Returns a list of lines and columns where the search pattern is found in the notecard.
|Return_text=containing a list of integers containing the locations of the found text.
|func_footnote=Returns [[NAK]] if the notecard is not cached.
|spec=
Searches the text of a cached notecard for lines containing the given pattern. It returns a list of line numbers and column where a match is found. 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.

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]].

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 notecard contains embedded inventory items (such as textures and landmarks), an empty list will be returned, regardless of the search string.
|constants
|examples
|also_functions={{LSL DefineRow||[[llGetNumberOfNotecardLines]]|}}
{{LSL DefineRow||[[llGetNotecardLine]]|}}
|also_events
|also_articles
|also_tests
|permission
|notes=
{{LSL Regular Expressions}}
|cat1=Notecard
|cat2=LSL
|cat3=
|cat4=
|history=
}}