RegexLocate and RegexLocateUp (Stringlist functions) - Revision history

Alex at 22:14, 21 January 2022

2022-01-21T22:14:17Z

@@ Line 22: / Line 22: @@
 <tr><th><var>Options</var></th>
-<td>This is an optional, [[Notation conventions for methods#Named parameters|name required]], parameter supplying a string of single letter options, which may be specified in uppercase or lowercase, in any combination, and blank separated or not as you prefer. For more information about these options, see [[Regex_processing#Common_regex_options|"Common regex options"]].
+<td>This is an optional, [[Notation conventions for methods#Named parameters|name required]], parameter supplying a string of single letter options, which may be specified in uppercase or lowercase, in any combination, and blank separated or not as you prefer. For more information about these options, see [[Regex_processing#Common_regex_options|Common regex options]].
-<table class="syntaxNested">
+</td></tr>
 <tr><th><var>Status</var></th>
@@ Line 111: / Line 98: @@
 ==See also==
 {{Template:Stringlist:RegexLocate and RegexLocateUp footer}}

JAL: /* Usage notes */ typo

2016-05-11T22:45:56Z

Usage notes: typo

← Older revision		Revision as of 22:45, 11 May 2016
Line 77:		Line 77:
	</ul>		</ul>

	<li>For information about additional methods and $functions that support regular expressions, see [[~~Regex_processing~~]].		<li>For information about additional methods and $functions that support regular expressions, see [[Regex processing]].
	</ul>		</ul>

JAL: link repair

2016-05-11T22:43:27Z

link repair

← Older revision		Revision as of 22:43, 11 May 2016
Line 66:		Line 66:
	<li>All errors in <var>RegexLocate</var> or <var>RegexLocateUp</var>, including invalid argument(s), will result in request cancellation.		<li>All errors in <var>RegexLocate</var> or <var>RegexLocateUp</var>, including invalid argument(s), will result in request cancellation.

	<li>It is strongly recommended that you protect your environment from regular expression processing demands on PDL and STBL space by setting, say, <code>UTABLE LPDLST 3000</code> and <code>UTABLE LSTBL 9000</code>. See [[~~Regex_processing~~#~~User_Language_programming_considerations~~\|~~"User Language~~ programming considerations"]].		<li>It is strongly recommended that you protect your environment from regular expression processing demands on PDL and STBL space by setting, say, <code>UTABLE LPDLST 3000</code> and <code>UTABLE LSTBL 9000</code>. See [[Regex processing#SOUL programming considerations\|SOUL programming considerations]].

	<li>The regex matching is limited to the first 6124 bytes of each item.		<li>The regex matching is limited to the first 6124 bytes of each item.
Line 77:		Line 77:
	</ul>		</ul>

	<li>For information about additional methods and $functions that support regular expressions, see [[Regex_processing~~\|"Regex Processing"~~]].		<li>For information about additional methods and $functions that support regular expressions, see [[Regex_processing]].

	~~<li> These methods are available as of <var class="product">[[Sirius Mods\|Sirius Mods]]</var> Version 6.9~~.
	</ul>		</ul>

JAL at 19:57, 31 October 2012

2012-10-31T19:57:33Z

Show changes

JALWiccan: 1 revision

2012-06-10T22:34:08Z

1 revision

← Older revision	Revision as of 22:34, 10 June 2012
(No difference)

JAL2: /* Examples */

2012-06-10T22:34:07Z

Examples

← Older revision		Revision as of 22:34, 10 June 2012
Line 17:		Line 17:
	<td>The item number from which the <var class="term">regex</var> matching is to begin. If this item is not matched, the method attempts to match the item with the next higher (if <var>RegexLocate</var>) or lower (if <var>RegexLocateUp</var>) item number, and so on. This numeric value is an optional argument that defaults to 1 (if <var>RegexLocate</var>) or to the number of items in <var class="term">sl</var> (if <var>RegexLocateUp</var>). This value must not be negative and must not be greater than the number of <var class="term">sl</var> items. Setting this argument to 0 is the same as setting it to 1.</td></tr>		<td>The item number from which the <var class="term">regex</var> matching is to begin. If this item is not matched, the method attempts to match the item with the next higher (if <var>RegexLocate</var>) or lower (if <var>RegexLocateUp</var>) item number, and so on. This numeric value is an optional argument that defaults to 1 (if <var>RegexLocate</var>) or to the number of items in <var class="term">sl</var> (if <var>RegexLocateUp</var>). This value must not be negative and must not be greater than the number of <var class="term">sl</var> items. Setting this argument to 0 is the same as setting it to 1.</td></tr>
	<tr><th><var>Options</var></th>		<tr><th><var>Options</var></th>
	<td>This is an optional, ~~but~~ [[Notation conventions for methods#Named parameters\|name required]], parameter supplying a string of single letter options, which may be specified in uppercase or lowercase, in any combination, and blank separated or not as you prefer. For more information about these options, see <var>[[Regex_processing#Common_regex_options\|"Common regex options"]]</var>.		<td>This is an optional, [[Notation conventions for methods#Named parameters\|name required]], parameter supplying a string of single letter options, which may be specified in uppercase or lowercase, in any combination, and blank separated or not as you prefer. For more information about these options, see <var>[[Regex_processing#Common_regex_options\|"Common regex options"]]</var>.
	<table class="syntaxNested">		<table class="syntaxNested">
	<tr><th><var>I</var></th>		<tr><th><var>I</var></th>

JAL2: /* Examples */

2012-02-22T22:07:50Z

Examples

← Older revision		Revision as of 22:07, 22 February 2012
Line 56:		Line 56:

	==Examples==		==Examples==
	~~<ol><li>~~
	In the following code fragment, <var>RegexLocate</var> is applied to the method <var>Stringlist</var> <code>%sl</code> to find the first occurrence of the string <code>'CUST'</code>. If this is successful, the containing item is copied to a new <var>Stringlist</var>. The matching is done case-insensitively, and the starting item is the beginning of the list, by default. Substituting <var>RegexLocateUp</var> for <var>RegexLocate</var> in the example would find the last occurrence of <code>'CUST'</code>.		In the following code fragment, <var>RegexLocate</var> is applied to the method <var>Stringlist</var> <code>%sl</code> to find the first occurrence of the string <code>'CUST'</code>. If this is successful, the containing item is copied to a new <var>Stringlist</var>. The matching is done case-insensitively, and the starting item is the beginning of the list, by default. Substituting <var>RegexLocateUp</var> for <var>RegexLocate</var> in the example would find the last occurrence of <code>'CUST'</code>.

Line 83:		Line 82:
	End If		End If
	...		...
	</p~~></ol~~>		</p>

	==See also==		==See also==
	{{Template:Stringlist:RegexLocate and RegexLocateUp footer}}		{{Template:Stringlist:RegexLocate and RegexLocateUp footer}}

Dme at 16:38, 7 February 2012

2012-02-07T16:38:36Z

← Older revision		Revision as of 16:38, 7 February 2012
Line 71:		Line 71:

	%opt='i'		%opt='i'
	%regex = '''cust'''		%regex = '''cust'''
	%itemnum = %sl:RegexLocate(%regex, Options=%opt, Status=%st)		%itemnum = %sl:RegexLocate(%regex, Options=%opt, Status=%st)
	If (%itemnum EQ 0) then		If (%itemnum EQ 0) then

JALWiccan: 1 revision

2011-05-04T17:45:45Z

1 revision

← Older revision	Revision as of 17:45, 4 May 2011
(No difference)

Tom at 17:45, 4 May 2011

2011-05-04T17:45:44Z

← Older revision		Revision as of 17:45, 4 May 2011
Line 53:		Line 53:
	<li>The request is cancelled in any of these cases:<ul><li>You specify an invalid argument option.<li>You omit the <var>Status</var> argument and a situation occurs that would cause a negative <var>Status</var> value.<li>You omit the <var>EndCol</var> argument and the length of an <var class="term">sl</var> item exceeds 6124 bytes.</ul>		<li>The request is cancelled in any of these cases:<ul><li>You specify an invalid argument option.<li>You omit the <var>Status</var> argument and a situation occurs that would cause a negative <var>Status</var> value.<li>You omit the <var>EndCol</var> argument and the length of an <var class="term">sl</var> item exceeds 6124 bytes.</ul>
	<li>For information about additional methods and $functions that support regular expressions, see [[Regex_processing\|"Regex Processing"]].		<li>For information about additional methods and $functions that support regular expressions, see [[Regex_processing\|"Regex Processing"]].
	<li> These methods are available as of <var class="product">[[Sirius Mods\|"Sirius Mods"]]</var> Version 6.9.</ul>		<li> These methods are available as of <var class="product">[[Sirius Mods\|Sirius Mods]]</var> Version 6.9.</ul>

	==Examples==		==Examples==