LocateUp (Stringlist function): Difference between revisions
Jump to navigation
Jump to search
m (more consistent layout and better tagging) |
mNo edit summary |
||
| Line 1: | Line 1: | ||
{{Template:Stringlist:LocateUp subtitle}} | {{Template:Stringlist:LocateUp subtitle}} | ||
This method locates a specified string in a <var>stringlist</var>, searching the <var>stringlist</var> items in reverse order. | This method locates a specified string in a <var>stringlist</var>, searching the <var>stringlist</var> items in reverse order. | ||
==Syntax== | ==Syntax== | ||
{{Template:Stringlist:LocateUp syntax}} | {{Template:Stringlist:LocateUp syntax}} | ||
| Line 22: | Line 22: | ||
<td>An indicator for case-insensitive comparisons. If this argument is a non-zero integer, the string comparisons use <var>stringlist</var> item data translated to uppercase (so the search target <var class="term">string</var> should be passed as an uppercase value). This is an optional argument, and it defaults to zero. If it is 1, the width of the searched column range is reduced to a maximum of 256.</td></tr> | <td>An indicator for case-insensitive comparisons. If this argument is a non-zero integer, the string comparisons use <var>stringlist</var> item data translated to uppercase (so the search target <var class="term">string</var> should be passed as an uppercase value). This is an optional argument, and it defaults to zero. If it is 1, the width of the searched column range is reduced to a maximum of 256.</td></tr> | ||
</table> | </table> | ||
==Usage notes== | ==Usage notes== | ||
<ul> | <ul> | ||
<li><var>LocateUp</var> returns a 0 if the indicated string is not found, and it cancels the request for all other errors.<li>While, under <var class="product">Sirius Mods</var> Version 6.6 and later, <var>stringlist</var> items can be longer than 6124 bytes long, the <var>LocateUp</var> method will only look for matches in the first 6124 bytes of any <var>Stringlist</var> item.</ul> | <li><var>LocateUp</var> returns a 0 if the indicated string is not found, and it cancels the request for all other errors.<li>While, under <var class="product">Sirius Mods</var> Version 6.6 and later, <var>stringlist</var> items can be longer than 6124 bytes long, the <var>LocateUp</var> method will only look for matches in the first 6124 bytes of any <var>Stringlist</var> item.</ul> | ||
==Examples== | ==Examples== | ||
The following code locates a string anywhere in a a <var>stringlist</var> <code>%list</code> item, searching backwards starting at item 100. | |||
%num = %list:locateUp('Vietnamerica', 100) | <p class="code"><nowiki>%num = %list:locateUp('Vietnamerica', 100) | ||
</ | </nowiki></p> | ||
==See also== | ==See also== | ||
{{Template:Stringlist:LocateUp footer}} | {{Template:Stringlist:LocateUp footer}} | ||
Revision as of 16:22, 28 February 2011
Locate previous Stringlist item containing string (Stringlist class)
This method locates a specified string in a stringlist, searching the stringlist items in reverse order.
Syntax
%itemNum = sl:LocateUp( string, [[Start=] number], [[StartColumn=] number], - [[EndColumn=] number], [[CaseIndependent=] number], - [[ArbitraryQuote=] number])
Syntax terms
| %itemNum | A numeric variable which will be set to the item number of the first item in the sl stringlist that contains the search target string, or it is set to a 0 if no items match the search criterion. |
|---|---|
| sl | A Stringlist object. |
| string | The target string to be located. This is a required argument, and it must be no longer than 255 bytes. |
| start | A number that indicates the item number at which the search is to begin. If this argument is not specified, searching begins at the last item in the stringlist. |
| startCol | A number that specifies the starting column of the range of columns within which the target string is searched for. This is an optional argument, and it defaults to 1. |
| endCol | A number that specifies the ending column of the range of columns within which the target string is searched for. This is an optional argument, and it defaults to 6124. If caseFlag is a non-zero integer, the width of the searched column range is reduced to a maximum of 256. |
| caseFlag | An indicator for case-insensitive comparisons. If this argument is a non-zero integer, the string comparisons use stringlist item data translated to uppercase (so the search target string should be passed as an uppercase value). This is an optional argument, and it defaults to zero. If it is 1, the width of the searched column range is reduced to a maximum of 256. |
Usage notes
- LocateUp returns a 0 if the indicated string is not found, and it cancels the request for all other errors.
- While, under Sirius Mods Version 6.6 and later, stringlist items can be longer than 6124 bytes long, the LocateUp method will only look for matches in the first 6124 bytes of any Stringlist item.
Examples
The following code locates a string anywhere in a a stringlist %list item, searching backwards starting at item 100.
%num = %list:locateUp('Vietnamerica', 100)