Find and FindUp (Stringlist functions) - Revision history

Ekern: /* Usage notes */

2022-02-11T18:11:18Z

Usage notes

← Older revision		Revision as of 18:11, 11 February 2022
Line 22:		Line 22:
	<ul>		<ul>
	<li>A return code of 0 from <var>Find</var> or <var>FindUp</var> indicates that the string was not found. All other errors result in request cancellation.		<li>A return code of 0 from <var>Find</var> or <var>FindUp</var> indicates that the string was not found. All other errors result in request cancellation.
	<li>The difference between <var>Find</var> / <var>FindUp</var> and <var>[[Locate and LocateUp (Stringlist functions)\|Locate]]</var> / <var>[[Locate and LocateUp (Stringlist functions)\|LocateUp]]</var> is that when <var>Find</var> or <var>FindUp</var> are used, a <var>Stringlist</var> item must exactly match the search <var class="term">string</var> rather than simply containing the search <var class="term">string</var>. Moreover, <var>Find</var> and <var>FindUp</var> do not allow specification of a range of columns (or positions) that are to be searched.<li><var>FindUp</var> is available in <var class="product">[[Sirius Mods]]</var> Version 6.9 and later.		<li>The difference between <var>Find</var> / <var>FindUp</var> and <var>[[Locate and LocateUp (Stringlist functions)\|Locate]]</var> / <var>[[Locate and LocateUp (Stringlist functions)\|LocateUp]]</var> is that when <var>Find</var> or <var>FindUp</var> are used, a <var>Stringlist</var> item must exactly match the search <var class="term">string</var> rather than simply containing the search <var class="term">string</var>. Moreover, <var>Find</var> and <var>FindUp</var> do not allow specification of a range of columns (or positions) that are to be searched.
			<li> When the search parameter is longer than 255 bytes, the <var>Find</var> function treats it as a String and not a longstring.
			<li><var>FindUp</var> is available in <var class="product">[[Sirius Mods]]</var> Version 6.9 and later.
	</ul>		</ul>

	==See also==		==See also==
	{{Template:Stringlist:Find and FindUp footer}}		{{Template:Stringlist:Find and FindUp footer}}

JALWiccan: 1 revision

2012-10-30T22:02:44Z

1 revision

← Older revision	Revision as of 22:02, 30 October 2012
(No difference)

JALWiccan: 1 revision

2012-10-30T22:02:32Z

1 revision

← Older revision		Revision as of 22:02, 30 October 2012
Line 16:		Line 16:
	<td>The <var class="term">string</var> to be matched. This is a required argument. </td></tr>		<td>The <var class="term">string</var> to be matched. This is a required argument. </td></tr>
	<tr><th>startItem </th>		<tr><th>startItem </th>
	<td>A number that indicates the item number at which the search is to begin. If this argument is not specified, searching begins at the first item in the <var>Stringlist</var> for <var>Find</var>, and at the last item for <var>FindUp</var>. Not specifying the starting item number is subtly different from specifying a starting item number of 1 -- the latter is an error if the <var>Stringlist</var> is empty, while the former simply returns a 0.</td></tr>		<td>A number that indicates the item number at which the search is to begin. If this argument is not specified, searching begins at the first item in the <var>Stringlist</var> for <var>Find</var>, and at the last item for <var>FindUp</var>. Not specifying the starting item number is subtly different from specifying a starting item number of 1 — the latter is an error if the <var>Stringlist</var> is empty, while the former simply returns a 0.</td></tr>
	</table>		</table>

JALWiccan: 1 revision

2011-05-24T17:38:49Z

1 revision

← Older revision	Revision as of 17:38, 24 May 2011
(No difference)

Goff at 17:38, 24 May 2011

2011-05-24T17:38:47Z

← Older revision		Revision as of 17:38, 24 May 2011
Line 22:		Line 22:
	<ul>		<ul>
	<li>A return code of 0 from <var>Find</var> or <var>FindUp</var> indicates that the string was not found. All other errors result in request cancellation.		<li>A return code of 0 from <var>Find</var> or <var>FindUp</var> indicates that the string was not found. All other errors result in request cancellation.
	<li>The difference between <var>Find</var> / <var>FindUp</var> and <var>[[Locate and LocateUp (Stringlist functions)\|Locate]]</var> / <var>[[Locate and LocateUp (Stringlist functions)\|LocateUp]]</var> is that when <var>Find</var> or <var>FindUp</var> are used, a <var>Stringlist</var> item must exactly match the search <var class="term">string</var> rather than simply containing the search <var class="term">string</var>. Moreover, <var>Find</var> and <var>FindUp</var> do not allow specification of a range of columns (or positions) that are to be searched.<li><var>FindUp</var> is available in <var class="product">[[Sirius Mods~~\|"Sirius Mods"~~]]</var> Version 6.9 and later.		<li>The difference between <var>Find</var> / <var>FindUp</var> and <var>[[Locate and LocateUp (Stringlist functions)\|Locate]]</var> / <var>[[Locate and LocateUp (Stringlist functions)\|LocateUp]]</var> is that when <var>Find</var> or <var>FindUp</var> are used, a <var>Stringlist</var> item must exactly match the search <var class="term">string</var> rather than simply containing the search <var class="term">string</var>. Moreover, <var>Find</var> and <var>FindUp</var> do not allow specification of a range of columns (or positions) that are to be searched.<li><var>FindUp</var> is available in <var class="product">[[Sirius Mods]]</var> Version 6.9 and later.
	</ul>		</ul>

	==See also==		==See also==
	{{Template:Stringlist:Find and FindUp footer}}		{{Template:Stringlist:Find and FindUp footer}}

Goff at 01:00, 18 May 2011

2011-05-18T01:00:18Z

← Older revision		Revision as of 01:00, 18 May 2011
Line 1:		Line 1:
	{{Template:Stringlist:Find and FindUp subtitle}}		{{Template:Stringlist:Find and FindUp subtitle}}

	Both these methods locate a <var>Stringlist</var> item that exactly matches a specified <var class="term">string</var>. The difference between <var>Find</var> and <var>FindUp</var> is the direction of the search: <var>Find</var> searches from the starting point in ascending item number order, while <var>FindUp</var> searches in descending item number order.		Both these methods locate a <var>Stringlist</var> item that exactly matches a specified <var class="term">string</var>. The difference between <var>Find</var> and <var>FindUp</var> is the direction of the search: <var>Find</var> searches from the starting point in ascending item number order, while <var>FindUp</var> searches in descending item number order.

Line 23:		Line 22:
	<ul>		<ul>
	<li>A return code of 0 from <var>Find</var> or <var>FindUp</var> indicates that the string was not found. All other errors result in request cancellation.		<li>A return code of 0 from <var>Find</var> or <var>FindUp</var> indicates that the string was not found. All other errors result in request cancellation.
	<li>The difference between <var>Find</var> / <var>FindUp</var> and <var>[[Locate and LocateUp (Stringlist functions)\|Locate]]</var> / <var>[[Locate and LocateUp (Stringlist functions)\|LocateUp]]</var> is that when <var>Find</var> or <var>FindUp</var> are used, a <var>Stringlist</var> item must exactly match the search <var class="term">string</var> rather than simply containing the search <var class="term">string</var>. Moreover, <var>Find</var> and <var>FindUp</var> do not allow specification of a range of columns (or positions) that are to be searched.<li><var>FindUp</var> is available in <var class="product">Sirius Mods</var> Version 6.9 and later.		<li>The difference between <var>Find</var> / <var>FindUp</var> and <var>[[Locate and LocateUp (Stringlist functions)\|Locate]]</var> / <var>[[Locate and LocateUp (Stringlist functions)\|LocateUp]]</var> is that when <var>Find</var> or <var>FindUp</var> are used, a <var>Stringlist</var> item must exactly match the search <var class="term">string</var> rather than simply containing the search <var class="term">string</var>. Moreover, <var>Find</var> and <var>FindUp</var> do not allow specification of a range of columns (or positions) that are to be searched.<li><var>FindUp</var> is available in <var class="product">[[Sirius Mods\|"Sirius Mods"]]</var> Version 6.9 and later.
	</ul>		</ul>

	==See also==		==See also==
	{{Template:Stringlist:Find and FindUp footer}}		{{Template:Stringlist:Find and FindUp footer}}

Dme at 18:16, 6 April 2011

2011-04-06T18:16:09Z

← Older revision		Revision as of 18:16, 6 April 2011
Line 23:		Line 23:
	<ul>		<ul>
	<li>A return code of 0 from <var>Find</var> or <var>FindUp</var> indicates that the string was not found. All other errors result in request cancellation.		<li>A return code of 0 from <var>Find</var> or <var>FindUp</var> indicates that the string was not found. All other errors result in request cancellation.
	<li>The difference between <var>Find</var> / <var>FindUp</var> and <var>[[Locate (Stringlist ~~function~~)\|Locate]]</var> / <var>[[LocateUp (Stringlist ~~function~~)\|LocateUp]]</var> is that when <var>Find</var> or <var>FindUp</var> are used, a <var>Stringlist</var> item must exactly match the search <var class="term">string</var> rather than simply containing the search <var class="term">string</var>. Moreover, <var>Find</var> and <var>FindUp</var> do not allow specification of a range of columns (or positions) that are to be searched.<li><var>FindUp</var> is available in <var class="product">Sirius Mods</var> Version 6.9 and later.		<li>The difference between <var>Find</var> / <var>FindUp</var> and <var>[[Locate and LocateUp (Stringlist functions)\|Locate]]</var> / <var>[[Locate and LocateUp (Stringlist functions)\|LocateUp]]</var> is that when <var>Find</var> or <var>FindUp</var> are used, a <var>Stringlist</var> item must exactly match the search <var class="term">string</var> rather than simply containing the search <var class="term">string</var>. Moreover, <var>Find</var> and <var>FindUp</var> do not allow specification of a range of columns (or positions) that are to be searched.<li><var>FindUp</var> is available in <var class="product">Sirius Mods</var> Version 6.9 and later.
	</ul>		</ul>

	==See also==		==See also==
	{{Template:Stringlist:Find and FindUp footer}}		{{Template:Stringlist:Find and FindUp footer}}

Goff: argh, another tag

2011-01-27T01:42:14Z

argh, another tag

← Older revision		Revision as of 01:42, 27 January 2011
Line 11:		Line 11:
	<table class="syntaxTable">		<table class="syntaxTable">
	<tr><th>%number </th>		<tr><th>%number </th>
	<td>A numeric variable that is set to the number of the first item in the <var>Stringlist</var> that matches the search <var class="term">string</var>, or it is set to 0 if the string is not found. </td></tr>		<td>A numeric variable that is set to the number of the first item in the <var>Stringlist</var> that matches the search <var class="term">string</var>, or it is set to 0 if the search <var class="term">string</var> is not found. </td></tr>
	<tr><th>sl </th>		<tr><th>sl </th>
	<td>A <var>Stringlist</var> object. </td></tr>		<td>A <var>Stringlist</var> object. </td></tr>

Goff: better tagging

2011-01-27T01:40:23Z

better tagging

← Older revision		Revision as of 01:40, 27 January 2011
Line 23:		Line 23:
	<ul>		<ul>
	<li>A return code of 0 from <var>Find</var> or <var>FindUp</var> indicates that the string was not found. All other errors result in request cancellation.		<li>A return code of 0 from <var>Find</var> or <var>FindUp</var> indicates that the string was not found. All other errors result in request cancellation.
	<li>The difference between <var>Find</var>/<var>FindUp</var> and ~~the~~ <var>[[Locate (Stringlist function)\|Locate]]</var> ~~and~~ <var>[[LocateUp (Stringlist function)\|LocateUp]]</var> is that when <var>Find</var> or <var>FindUp</var> are used, a <var>Stringlist</var> item must match the search <var class="term">string</var> ~~exactly~~ rather than simply ~~contain~~ the search string. Moreover, <var>Find</var> and <var>FindUp</var> do not allow specification of a range of columns (or positions) that are to be searched.<li>~~The~~ <var>FindUp</var> ~~method~~ is available in <var class="product">Sirius Mods</var> Version 6.9 and later.		<li>The difference between <var>Find</var> / <var>FindUp</var> and <var>[[Locate (Stringlist function)\|Locate]]</var> / <var>[[LocateUp (Stringlist function)\|LocateUp]]</var> is that when <var>Find</var> or <var>FindUp</var> are used, a <var>Stringlist</var> item must exactly match the search <var class="term">string</var> rather than simply containing the search <var class="term">string</var>. Moreover, <var>Find</var> and <var>FindUp</var> do not allow specification of a range of columns (or positions) that are to be searched.<li><var>FindUp</var> is available in <var class="product">Sirius Mods</var> Version 6.9 and later.
	</ul>		</ul>

	==See also==		==See also==
	{{Template:Stringlist:Find and FindUp footer}}		{{Template:Stringlist:Find and FindUp footer}}

Goff: camelCase

2011-01-27T00:00:35Z

camelCase

← Older revision		Revision as of 00:00, 27 January 2011
Line 16:		Line 16:
	<tr><th>string </th>		<tr><th>string </th>
	<td>The <var class="term">string</var> to be matched. This is a required argument. </td></tr>		<td>The <var class="term">string</var> to be matched. This is a required argument. </td></tr>
	<tr><th>~~startitem~~ </th>		<tr><th>startItem </th>
	<td>A number that indicates the item number at which the search is to begin. If this argument is not specified, searching begins at the first item in the <var>Stringlist</var> for <var>Find</var>, and at the last item for <var>FindUp</var>. Not specifying the starting item number is subtly different from specifying a starting item number of 1 -- the latter is an error if the <var>Stringlist</var> is empty, while the former simply returns a 0.</td></tr>		<td>A number that indicates the item number at which the search is to begin. If this argument is not specified, searching begins at the first item in the <var>Stringlist</var> for <var>Find</var>, and at the last item for <var>FindUp</var>. Not specifying the starting item number is subtly different from specifying a starting item number of 1 -- the latter is an error if the <var>Stringlist</var> is empty, while the former simply returns a 0.</td></tr>
	</table>		</table>