New (Regex constructor) - Revision history

Alex: /* Syntax terms */

2022-03-23T19:58:16Z

Syntax terms

← Older revision		Revision as of 19:58, 23 March 2022
Line 12:		Line 12:
	<td>The regular expression string to be compiled to create the <var>Regex</var> object.</td></tr>		<td>The regular expression string to be compiled to create the <var>Regex</var> object.</td></tr>
	<tr><th><var>replace</var></th>		<tr><th><var>replace</var></th>
	<td>A replacement string to be compiled into the <var>Regex</var> object. If specified, this string is used by the [[Replace (Regex function)\|Replace function]] if no replacement string is specified for a call. If <var>replace</var> is not specified, a replacement string must be specified for any <var>Replace</var> using the <var>Regex</var> object.</td></tr>		<td>A replacement string to be compiled into the <var>Regex</var> object. If specified, this string is used by the [[Replace (Regex function)\|Replace function]] if no replacement string is specified for a call. If <var>replace</var> is not specified, a replacement string must be specified for any <var>Replace</var> using the <var>Regex</var> object.
			<p>See the [[Replace (Regex function)\|Replace function]] for more information on the interpretation of the replacement string.</p>
			</td></tr>
	<tr><th><var>options</var></th>		<tr><th><var>options</var></th>
	<td>A string of single letter options, which may be specified in uppercase or lowercase, in any combination, and blank separated or not. For more information about these options, see [[Regex_processing#Common_regex_options\|Common regex options]].		<td>A string of single letter options, which may be specified in uppercase or lowercase, in any combination, and blank separated or not. For more information about these options, see [[Regex_processing#Common_regex_options\|Common regex options]].
	</td></tr>		</td></tr>
	</table>		</table>

	==Usage notes==		==Usage notes==
	<ul>		<ul>

Alex at 03:20, 23 March 2022

2022-03-23T03:20:40Z

← Older revision		Revision as of 03:20, 23 March 2022
Line 1:		Line 1:
	{{Template:Regex:New subtitle}}		{{Template:Regex:New subtitle}}

	This ~~page is [[under construction]]~~.		This constructor creates a new instance of the <var>Regex</var> class.
	==Syntax==		==Syntax==
	{{Template:Regex:New syntax}}		{{Template:Regex:New syntax}}
	===Syntax terms===		===Syntax terms===
	<table class="syntaxTable">		<table class="syntaxTable">
	<tr><th>%outRegex</th><td>~~regex~~</td></tr>		<tr><th>%outRegex</th><td>The new <var>Regex</var> object.</td></tr>
	<tr><th nowrap="true"><var>[%(Regex):]</var></th>		<tr><th nowrap="true"><var>[%(Regex):]</var></th>
	<td>The optional class name in parentheses denotes a <var>[[Notation conventions for methods#Constructors\|Constructor]]~~</var>. See [[#Usage notes\|"Usage notes"]], below, for more information about invoking a <var>Constructor~~</var>.</td></tr>		<td>The optional class name in parentheses denotes a <var>[[Notation conventions for methods#Constructors\|Constructor]]</var>.</td></tr>
	<tr><th>regex</th>		<tr><th>regex</th>
	<td>string</td></tr>		<td>The regular expression string to be compiled to create the <var>Regex</var> object.</td></tr>
	<tr><th><var>~~Replace~~</var></th>		<tr><th><var>replace</var></th>
	<td>string<br/>~~The default value of~~ this ~~argument~~ is [[??]].</td></tr>		<td>A replacement string to be compiled into the <var>Regex</var> object. If specified, this string is used by the [[Replace (Regex function)\|Replace function]] if no replacement string is specified for a call. If <var>replace</var> is not specified, a replacement string must be specified for any <var>Replace</var> using the <var>Regex</var> object.</td></tr>
	<tr><th><var>~~Options~~</var></th>		<tr><th><var>options</var></th>
	<td>string~~<br/>The default value~~ of ~~this argument is~~ [[??]].</td></tr>		<td>A string of single letter options, which may be specified in uppercase or lowercase, in any combination, and blank separated or not. For more information about these options, see [[Regex_processing#Common_regex_options\|Common regex options]].
			</td></tr>
	</table>		</table>
	==Usage notes==		==Usage notes==
			<ul>
			<li>If <var>regex</var> is a literal string, it is compiled at the time the containing SOUL program is compiled and the compiled regular expression is simply loaded into the <var>Regex</var> object. The same is true of the <var>replace</var> string if one is present.</li>
			<li><var>regex</var> and <var>replace</var> (including the source strings) must compile to a length less than or equal to the value of the [[REGXSTBL parameter]]. If it does not, te request is canceled.</li>
			<li>If <var>regex</var> is a <var>Unicode</var> value, the <var>Regex</var> object will do Unicode matching.</li>
			</ul>
	==Examples==		==Examples==
			The following example creates a <var>Regex</var> object that does a case-independent search for the letters "foobar" with arbitrary characters between them:
			<p class="code">%regex is object regex
			...
			%regex = new("f.o.o.b.a.*r", options="i")
			</p>
	==See also==		==See also==
	{{Template:Regex:New footer}}		{{Template:Regex:New footer}}

			[[Category:Regular expression processing]]

Wiccan: Automatically generated page update

2022-03-23T01:13:08Z

Automatically generated page update

New page

{{Template:Regex:New subtitle}}

This page is [[under construction]].
==Syntax==
{{Template:Regex:New syntax}}
===Syntax terms===
<table class="syntaxTable">
<tr><th>%outRegex</th><td>regex</td></tr>
<tr><th nowrap="true"><var>[%(Regex):]</var></th>
<td>The optional class name in parentheses denotes a <var>[[Notation conventions for methods#Constructors|Constructor]]</var>. See [[#Usage notes|"Usage notes"]], below, for more information about invoking a <var>Constructor</var>.</td></tr>
<tr><th>regex</th>
<td>string</td></tr>
<tr><th><var>Replace</var></th>
<td>string<br/>The default value of this argument is [[??]].</td></tr>
<tr><th><var>Options</var></th>
<td>string<br/>The default value of this argument is [[??]].</td></tr>
</table>
==Usage notes==
==Examples==
==See also==
{{Template:Regex:New footer}}