InvalidRegex class - Revision history

Alex at 22:10, 21 January 2022

2022-01-21T22:10:23Z

← Older revision		Revision as of 22:10, 21 January 2022
Line 100:		Line 100:

	[[Category:System exception classes]]		[[Category:System exception classes]]
			[[Category:Regular expression processing]]

JAL: misc formatting

2016-05-11T17:46:04Z

misc formatting

← Older revision		Revision as of 17:46, 11 May 2016
Line 3:		Line 3:
	The <var>InvalidRegex</var> exception class describes an exception associated with an invalid [[Regex_processing\|regular expression]] being passed to a method that takes a regular expression argument.		The <var>InvalidRegex</var> exception class describes an exception associated with an invalid [[Regex_processing\|regular expression]] being passed to a method that takes a regular expression argument.

	To produce an <var>InvalidRegex</var> exception yourself, you typically use a <var class="product">User Language</var> <var>[[Exceptions#Throwing exceptions\|Throw]]</var> statement with an <var>InvalidRegex</var> <var>[[New_(InvalidRegex_constructor)\|New]]</var> constructor. This statement must be issued from within a method, and it can only be caught by the code that calls the method. For example, the following statement throws an <var>InvalidRegex</var> exception with the position set to <code>13</code>, the code set to <code>666</code>, and the description indicating <code>Bad luck</code>:		To produce an <var>InvalidRegex</var> exception yourself, you typically use a <var class="product">User Language</var> <var>[[Exceptions#Throwing exceptions\|Throw]]</var> statement with an <var>InvalidRegex</var> <var>[[New_(InvalidRegex_constructor)\|New]]</var> constructor. This statement must be issued from within a method, and it can only be caught by the code that calls the method. For example, the following statement throws an <var>InvalidRegex</var> exception with the position set to <code>13</code>, the code set to <code>666</code>, and the description indicating <code>Bad luck</code>:
	<p class="code">throw %(invalidRegex):new(position=13, code=666, description='Bad luck')		<p class="code">throw %(invalidRegex):new(position=13, code=666, description='Bad luck')
	</p>		</p>
Line 12:		Line 12:
	The methods in the class are described in the subsections that follow. In addition:		The methods in the class are described in the subsections that follow. In addition:
	<ul>		<ul>
	<li>[[Notation conventions for methods~~\|"Notation conventions for methods"~~]] has information		<li>[[Notation conventions for methods]] has information about the conventions followed. </li>
	about the conventions followed.
	<li>[[InvalidRegex methods syntax~~\|"InvalidRegex methods syntax"~~]] is a single page that contains the syntax diagrams of all the methods in the class.		<li>[[InvalidRegex methods syntax]] is a single page that contains the syntax diagrams of all the methods in the class. </li>
	</ul>		</ul>

Line 22:		Line 22:

	This <var>[[Classes and Objects#readWrite\|ReadOnly]]</var> property is an integer code that provides some details about the nature of the error. This code is really only useful to someone familiar with the implementation of the regular expression processor, so it is likely to be useful only to [[Contacting Rocket Software Technical Support\|Technical Support]].		This <var>[[Classes and Objects#readWrite\|ReadOnly]]</var> property is an integer code that provides some details about the nature of the error. This code is really only useful to someone familiar with the implementation of the regular expression processor, so it is likely to be useful only to [[Contacting Rocket Software Technical Support\|Technical Support]].
	<p>No assumptions should be made that a particular error will always produce the same code from release to release of ~~the~~ <var class="product">[[~~Sirius Mods\|Sirius Mods~~]]</var>, or even between runs of an Online.</p>		<p>
			No assumptions should be made that a particular error will always produce the same code from release to release of <var class="product">[[Model 204]]</var>, or even between runs of an Online.</p>

	===Syntax===		===Syntax===
Line 28:		Line 29:

	====Syntax terms====		====Syntax terms====
	<table ~~class="syntaxTable"~~>		<table>
	<tr><th>%number</th>		<tr><th>%number</th>
	<td>This integer value is associated with the regular expression error.</td></tr>		<td>This integer value is associated with the regular expression error.</td></tr>
Line 59:		Line 60:
	This <var>Constructor</var> generates an instance of an <var>[[InvalidRegex_class\|InvalidRegex]]</var> exception.		This <var>Constructor</var> generates an instance of an <var>[[InvalidRegex_class\|InvalidRegex]]</var> exception.
	<p>		<p>
	As shown below, the required arguments of the <var>New</var> method are the <var>[[~~Code_~~(InvalidRegex_property)\|Code]]</var>, <var>[[~~Description_~~(~~InvalidRegex_property~~)\|Description]]</var>, and <var>[[~~Position_~~(~~InvalidRegex_property~~)\|Position]]</var> properties. Each argument to <var>New</var> sets the value of the corresponding property of the newly constructed <var>InvalidRegex</var> object.</p>		As shown below, the required arguments of the <var>New</var> method are the <var>[[Code (InvalidRegex_property)\|Code]]</var>, <var>[[Description (InvalidRegex property)\|Description]]</var>, and <var>[[Position (InvalidRegex property)\|Position]]</var> properties. Each argument to <var>New</var> sets the value of the corresponding property of the newly constructed <var>InvalidRegex</var> object.</p>

	===Syntax===		===Syntax===
Line 65:		Line 66:

	====Syntax terms====		====Syntax terms====
	<table ~~class="syntaxTable"~~>		<table>
	<tr><th>%invalidRegex</th>		<tr><th>%invalidRegex</th>
	<td>A reference to an instance of an <var>InvalidRegex</var> object.</td></tr>		<td>A reference to an instance of an <var>InvalidRegex</var> object.</td></tr>
Line 90:		Line 91:

	====Syntax terms====		====Syntax terms====
	<table ~~class="syntaxTable"~~>		<table>
	<tr><th>%number</th>		<tr><th>%number</th>
	<td>This numeric value is the position in the regular expression where the error was detected.</td></tr>		<td>This numeric value is the position in the regular expression where the error was detected.</td></tr>

	<tr><th>invalidRegex</th>		<tr><th>invalidRegex</th>
	<td>A reference to an instance of an <var>[[InvalidRegex_class\|InvalidRegex]]</var> object.		<td>A reference to an instance of an <var>[[InvalidRegex_class\|InvalidRegex]]</var> object.</td></tr>
			</table>
	</td></tr></table>


	[[Category:System exception classes]]		[[Category:System exception classes]]

ELowell: /* Code property */

2013-07-23T21:21:29Z

Code property

← Older revision		Revision as of 21:21, 23 July 2013
Line 21:		Line 21:
	{{Template:InvalidRegex:Code subtitle}}		{{Template:InvalidRegex:Code subtitle}}

	This <var>[[Classes and Objects#readWrite\|ReadOnly]]</var> property is an integer code that provides some details about the nature of the error. This code is really only useful to someone familiar with the implementation of the regular expression processor, so it is likely to be useful only to [~~http://m204wiki.rocketsoftware.com/index.php/Contacting_Rocket_Software_Technical_Support~~ Technical Support].		This <var>[[Classes and Objects#readWrite\|ReadOnly]]</var> property is an integer code that provides some details about the nature of the error. This code is really only useful to someone familiar with the implementation of the regular expression processor, so it is likely to be useful only to [[Contacting Rocket Software Technical Support\|Technical Support]].
	<p>No assumptions should be made that a particular error will always produce the same code from release to release of the <var class="product">[[Sirius Mods\|Sirius Mods]]</var>, or even between runs of an Online.</p>		<p>No assumptions should be made that a particular error will always produce the same code from release to release of the <var class="product">[[Sirius Mods\|Sirius Mods]]</var>, or even between runs of an Online.</p>

ELowell: /* Code property */

2013-07-23T21:20:04Z

Code property

← Older revision		Revision as of 21:20, 23 July 2013
Line 21:		Line 21:
	{{Template:InvalidRegex:Code subtitle}}		{{Template:InvalidRegex:Code subtitle}}

	This <var>[[Classes and Objects#readWrite\|ReadOnly]]</var> property is an integer code that provides some details about the nature of the error. This code is really only useful to someone familiar with the implementation of the regular expression processor, so it is likely to be useful only to [http://~~sirius-software~~.com/~~support~~.~~html Sirius Software technical support~~].		This <var>[[Classes and Objects#readWrite\|ReadOnly]]</var> property is an integer code that provides some details about the nature of the error. This code is really only useful to someone familiar with the implementation of the regular expression processor, so it is likely to be useful only to [http://m204wiki.rocketsoftware.com/index.php/Contacting_Rocket_Software_Technical_Support Technical Support].
	<p>No assumptions should be made that a particular error will always produce the same code from release to release of the <var class="product">[[Sirius Mods\|Sirius Mods]]</var>, or even between runs of an Online.</p>		<p>No assumptions should be made that a particular error will always produce the same code from release to release of the <var class="product">[[Sirius Mods\|Sirius Mods]]</var>, or even between runs of an Online.</p>

Line 35:		Line 35:
	<td>A reference to an instance of an <var>[[InvalidRegex_class\|InvalidRegex]]</var> object.		<td>A reference to an instance of an <var>[[InvalidRegex_class\|InvalidRegex]]</var> object.
	</td></tr></table>		</td></tr></table>


	==Description property==		==Description property==

JAL at 20:17, 23 July 2013

2013-07-23T20:17:52Z

← Older revision		Revision as of 20:17, 23 July 2013
Line 1:		Line 1:
	<!-- InvalidRegex class -->		<!-- InvalidRegex class -->
	~~<!--~~ __NOTOC__ ~~-->~~		__NOTOC__
	The <var>InvalidRegex</var> exception class describes an exception associated with an invalid [[Regex_processing\|regular expression]] being passed to a method that takes a regular expression argument.		The <var>InvalidRegex</var> exception class describes an exception associated with an invalid [[Regex_processing\|regular expression]] being passed to a method that takes a regular expression argument.

Dme at 19:37, 23 July 2013

2013-07-23T19:37:08Z

← Older revision		Revision as of 19:37, 23 July 2013
Line 1:		Line 1:
	<!-- InvalidRegex class -->		<!-- InvalidRegex class -->
	__NOTOC__		<!-- __NOTOC__ -->
	The <var>InvalidRegex</var> exception class describes an exception associated with an invalid [[Regex_processing\|regular expression]] being passed to a method that takes a regular expression argument.		The <var>InvalidRegex</var> exception class describes an exception associated with an invalid [[Regex_processing\|regular expression]] being passed to a method that takes a regular expression argument.

JAL at 22:30, 21 November 2012

2012-11-21T22:30:22Z

New page

__NOTOC__
The <var>InvalidRegex</var> exception class describes an exception associated with an invalid [[Regex_processing|regular expression]] being passed to a method that takes a regular expression argument.

To produce an <var>InvalidRegex</var> exception yourself, you typically use a <var class="product">User Language</var> <var>[[Exceptions#Throwing exceptions|Throw]]</var> statement with an <var>InvalidRegex</var> <var>[[New_(InvalidRegex_constructor)|New]]</var> constructor. This statement must be issued from within a method, and it can only be caught by the code that calls the method. For example, the following statement throws an <var>InvalidRegex</var> exception with the position set to <code>13</code>, the code set to <code>666</code>, and the description indicating <code>Bad luck</code>:
<p class="code">throw %(invalidRegex):new(position=13, code=666, description='Bad luck')
</p>

==The InvalidRegex methods==
{{Template:List of InvalidRegex methods}}

The methods in the class are described in the subsections that follow. In addition:
<ul>
<li>[[Notation conventions for methods|"Notation conventions for methods"]] has information
about the conventions followed.
<li>[[InvalidRegex methods syntax|"InvalidRegex methods syntax"]] is a single page that contains the syntax diagrams of all the methods in the class.
</ul>

==Code property==
{{Template:InvalidRegex:Code subtitle}}

This <var>[[Classes and Objects#readWrite|ReadOnly]]</var> property is an integer code that provides some details about the nature of the error. This code is really only useful to someone familiar with the implementation of the regular expression processor, so it is likely to be useful only to [http://sirius-software.com/support.html Sirius Software technical support].
<p>No assumptions should be made that a particular error will always produce the same code from release to release of the <var class="product">[[Sirius Mods|Sirius Mods]]</var>, or even between runs of an Online.</p>

===Syntax===
{{Template:InvalidRegex:Code syntax}}

====Syntax terms====
<table class="syntaxTable">
<tr><th>%number</th>
<td>This integer value is associated with the regular expression error.</td></tr>

<tr><th>invalidRegex</th>
<td>A reference to an instance of an <var>[[InvalidRegex_class|InvalidRegex]]</var> object.
</td></tr></table>

==Description property==
{{Template:InvalidRegex:Description subtitle}}

This <var>ReadOnly</var> property is a text explanation of the problem. As descriptive text tends to do, this text ''might'' change between releases of the <var class="product">Sirius Mods</var>.

===Syntax===
{{Template:InvalidRegex:Description syntax}}

====Syntax terms====
<table class="syntaxTable">
<tr><th>%string</th>
<td>This string value describes the regular expression error.</td></tr>

<tr><th>invalidRegex</th>
<td>A reference to an instance of an <var>[[InvalidRegex_class|InvalidRegex]]</var> object.
</td></tr></table>

==New constructor==
{{Template:InvalidRegex:New subtitle}}

This <var>Constructor</var> generates an instance of an <var>[[InvalidRegex_class|InvalidRegex]]</var> exception.
<p>
As shown below, the required arguments of the <var>New</var> method are the <var>[[Code_(InvalidRegex_property)|Code]]</var>, <var>[[Description_(InvalidRegex_property)|Description]]</var>, and <var>[[Position_(InvalidRegex_property)|Position]]</var> properties. Each argument to <var>New</var> sets the value of the corresponding property of the newly constructed <var>InvalidRegex</var> object.</p>

===Syntax===
{{Template:InvalidRegex:New syntax}}

====Syntax terms====
<table class="syntaxTable">
<tr><th>%invalidRegex</th>
<td>A reference to an instance of an <var>InvalidRegex</var> object.</td></tr>

<tr><th><var>[%(InvalidRegex):]</var></th><td>The class name in parentheses denotes a <var>[[Notation conventions for methods#Constructors|Constructor]]</var>.</td></tr>

<tr><th><var>Code</var></th>
<td>This [[Methods#Named parameters|name required]] parameter specifies the numeric value (<var class="term">number</var>) to be assigned to the exception object's <var>Code</var> property.</td></tr>

<tr><th><var>Description</var></th>
<td>This name required parameter specifies the string value (<var class="term">string</var>) to be assigned to the object's <var>Description</var> property.</td></tr>

<tr><th><var>Position</var></th>
<td>This name required parameter specifies the numeric value (<var class="term">number</var>) to be assigned to the object's <var>Position</var> property.</td></tr>
</table>

==Position property==
{{Template:InvalidRegex:Position subtitle}}

This <var>ReadOnly</var> property is the position in the [[Regex_processing|regular expression]] that is determined to be where the regular expression was invalid. It is possible that the mistake was earlier but was not detected until later.

===Syntax===
{{Template:InvalidRegex:Position syntax}}

====Syntax terms====
<table class="syntaxTable">
<tr><th>%number</th>
<td>This numeric value is the position in the regular expression where the error was detected.</td></tr>

<tr><th>invalidRegex</th>
<td>A reference to an instance of an <var>[[InvalidRegex_class|InvalidRegex]]</var> object.

</td></tr></table>

[[Category:System exception classes]]

JAL2 at 17:59, 7 August 2012

2012-08-07T17:59:50Z

← Older revision		Revision as of 17:59, 7 August 2012
Line 4:		Line 4:

	To produce an <var>InvalidRegex</var> exception yourself, you typically use a <var class="product">User Language</var> <var>[[Exceptions#Throwing exceptions\|Throw]]</var> statement with an <var>InvalidRegex</var> <var>[[New_(InvalidRegex_constructor)\|New]]</var> constructor. This statement must be issued from within a method, and it can only be caught by the code that calls the method. For example, the following statement throws an <var>InvalidRegex</var> exception with the position set to <code>13</code>, the code set to <code>666</code>, and the description indicating <code>Bad luck</code>:		To produce an <var>InvalidRegex</var> exception yourself, you typically use a <var class="product">User Language</var> <var>[[Exceptions#Throwing exceptions\|Throw]]</var> statement with an <var>InvalidRegex</var> <var>[[New_(InvalidRegex_constructor)\|New]]</var> constructor. This statement must be issued from within a method, and it can only be caught by the code that calls the method. For example, the following statement throws an <var>InvalidRegex</var> exception with the position set to <code>13</code>, the code set to <code>666</code>, and the description indicating <code>Bad luck</code>:
	<p class="code"> throw %(invalidRegex):new(position=13, code=666, -		<p class="code"> throw %(invalidRegex):new(position=13, code=666, description='Bad luck')
	description='Bad luck')
	</p>		</p>

JAL2 at 17:59, 7 August 2012

2012-08-07T17:59:10Z

← Older revision		Revision as of 17:59, 7 August 2012
Line 3:		Line 3:
	The <var>InvalidRegex</var> exception class describes an exception associated with an invalid [[Regex_processing\|regular expression]] being passed to a method that takes a regular expression argument.		The <var>InvalidRegex</var> exception class describes an exception associated with an invalid [[Regex_processing\|regular expression]] being passed to a method that takes a regular expression argument.

	To produce an <var>InvalidRegex</var> exception yourself, you typically use a <var class="product">User Language</var> <var>[[Throw]]</var> statement with an <var>InvalidRegex</var> <var>[[New_(InvalidRegex_constructor)\|New]]</var> constructor. This statement must be issued from within a method, and it can only be caught by the code that calls the method. For example, the following statement throws an <var>InvalidRegex</var> exception with the position set to <code>13</code>, the code set to <code>666</code>, and the description indicating <code>Bad luck</code>:		To produce an <var>InvalidRegex</var> exception yourself, you typically use a <var class="product">User Language</var> <var>[[Exceptions#Throwing exceptions\|Throw]]</var> statement with an <var>InvalidRegex</var> <var>[[New_(InvalidRegex_constructor)\|New]]</var> constructor. This statement must be issued from within a method, and it can only be caught by the code that calls the method. For example, the following statement throws an <var>InvalidRegex</var> exception with the position set to <code>13</code>, the code set to <code>666</code>, and the description indicating <code>Bad luck</code>:
	<p class="code"> [[throw]] %(invalidRegex):new(position=13, code=666, -		<p class="code"> throw %(invalidRegex):new(position=13, code=666, -
	description='Bad luck')		description='Bad luck')
	</p>		</p>

	~~<h2>~~The InvalidRegex methods~~</h2>~~		==The InvalidRegex methods==
	{{Template:List of InvalidRegex methods}}		{{Template:List of InvalidRegex methods}}

Line 54:		Line 54:


	~~<h2>~~New constructor~~</h2>~~		==New constructor==
	{{Template:InvalidRegex:New subtitle}}		{{Template:InvalidRegex:New subtitle}}

Line 62:		Line 62:
	<h3>Syntax</h3>		<h3>Syntax</h3>
	{{Template:InvalidRegex:New syntax}}		{{Template:InvalidRegex:New syntax}}

	<h4>Syntax terms</h4>		<h4>Syntax terms</h4>
	<table class="syntaxTable">		<table class="syntaxTable">
Line 67:		Line 68:
	<td>A reference to an instance of an <var>InvalidRegex</var> object.		<td>A reference to an instance of an <var>InvalidRegex</var> object.
	</td></tr>		</td></tr>
	<tr><th><var>%(InvalidRegex)</var></th><td>The class name in parentheses denotes a <var>[[Notation conventions for methods#Constructors\|Constructor]]</var>.</td></tr>
			<tr><th><var>[%(InvalidRegex):]</var></th><td>The class name in parentheses denotes a <var>[[Notation conventions for methods#Constructors\|Constructor]]</var>.</td></tr>

	<tr><th><var>Code</var></th>		<tr><th><var>Code</var></th>
	<td>This [[Methods#Named parameters\|name required]] parameter specifies the numeric value (<var class="term">number</var>) to be assigned to the exception object's <var>[[Code_(InvalidRegex_property)\|Code]]</var> property.		<td>This [[Methods#Named parameters\|name required]] parameter specifies the numeric value (<var class="term">number</var>) to be assigned to the exception object's <var>[[Code_(InvalidRegex_property)\|Code]]</var> property.
	</td></tr>		</td></tr>

	<tr><th><var>Description</var></th>		<tr><th><var>Description</var></th>
	<td>This name required parameter specifies the string value (<var class="term">string</var>) to be assigned to the object's <var>[[Description_(InvalidRegex_property)\|Description]]</var> property.		<td>This name required parameter specifies the string value (<var class="term">string</var>) to be assigned to the object's <var>[[Description_(InvalidRegex_property)\|Description]]</var> property.
	</td></tr>		</td></tr>

	<tr><th><var>Position</var></th>		<tr><th><var>Position</var></th>
	<td>This name required parameter specifies the numeric value (<var class="term">number</var>) to be assigned to the object's <var>[[Position_(InvalidRegex_property)\|Position]]</var> property.		<td>This name required parameter specifies the numeric value (<var class="term">number</var>) to be assigned to the object's <var>[[Position_(InvalidRegex_property)\|Position]]</var> property.

JAL2 at 20:57, 27 July 2011

2011-07-27T20:57:56Z

← Older revision		Revision as of 20:57, 27 July 2011
Line 57:		Line 57:
	{{Template:InvalidRegex:New subtitle}}		{{Template:InvalidRegex:New subtitle}}

	This ~~constructor~~ generates an instance of an <var>[[InvalidRegex_class\|InvalidRegex]]</var> exception.		This <var>Constructor</var> generates an instance of an <var>[[InvalidRegex_class\|InvalidRegex]]</var> exception.
	<p>As shown below, the required arguments of the <var>New</var> method is the <var>[[Code_(InvalidRegex_property)\|Code]]</var>, <var>[[Description_(InvalidRegex_property)\|Description]]</var>, and <var>[[Position_(InvalidRegex_property)\|Position]]</var> properties. Each argument to <var>New</var> sets the value of the corresponding property of the newly constructed <var>InvalidRegex</var> object.</p>		<p>As shown below, the required arguments of the <var>New</var> method is the <var>[[Code_(InvalidRegex_property)\|Code]]</var>, <var>[[Description_(InvalidRegex_property)\|Description]]</var>, and <var>[[Position_(InvalidRegex_property)\|Position]]</var> properties. Each argument to <var>New</var> sets the value of the corresponding property of the newly constructed <var>InvalidRegex</var> object.</p>

Line 67:		Line 67:
	<td>A reference to an instance of an <var>InvalidRegex</var> object.		<td>A reference to an instance of an <var>InvalidRegex</var> object.
	</td></tr>		</td></tr>
	<tr><th><var>%(InvalidRegex)</var></th><td>The class name in parentheses denotes a ~~shared method~~.</td></tr>		<tr><th><var>%(InvalidRegex)</var></th><td>The class name in parentheses denotes a <var>[[Notation conventions for methods#Constructors\|Constructor]]</var>.</td></tr>
	<tr><th><var>Code</var></th>		<tr><th><var>Code</var></th>
	<td>This [[Methods#Named parameters\|name required]] parameter specifies the numeric value (<var class="term">number</var>) to be assigned to the exception object's <var>[[Code_(InvalidRegex_property)\|Code]]</var> property.		<td>This [[Methods#Named parameters\|name required]] parameter specifies the numeric value (<var class="term">number</var>) to be assigned to the exception object's <var>[[Code_(InvalidRegex_property)\|Code]]</var> property.