InvalidValue class - Revision history

JAL: misc formatting

2016-03-15T18:51:42Z

misc formatting

← Older revision		Revision as of 18:51, 15 March 2016
Line 1:		Line 1:
	~~<!-- InvalidValue class -->~~
	__NOTOC__		__NOTOC__
	An <var>InvalidValue</var> exception indicates that a given value is not associated with a given enumeration. For example:		An <var>InvalidValue</var> exception indicates that a given value is not associated with a given enumeration. For example:
	<p class="code">enumeration foo		<p class="code">enumeration foo
	public		public
	attribute x is float inverse fromX		attribute x is float inverse fromX
	value y (3)		value y (3)
	allow ordinal		allow ordinal
	end public		end public
	end enumeration		end enumeration
	%f is enumeration foo		%f is enumeration foo
	%f = fromString('Y')		%f = fromString('Y')
	printText {~=%f}		printText {~=%f}
	%f = fromX(3)		%f = fromX(3)
	printText {~=%f}		printText {~=%f}
	try		try
	%f = fromString('z')		%f = fromString('z')
	catch invalidValue		catch invalidValue
	print 'z is not a foo enumeration string value'		print 'z is not a foo enumeration string value'
	end try		end try
	try		try
	%f = fromX(1)		%f = fromX(1)
	catch invalidValue		catch invalidValue
	print '1 is not a foo enumeration x attribute value'		print '1 is not a foo enumeration x attribute value'
	end try		end try
Line 29:		Line 28:
	</p>		</p>
	The result of the above fragment is:		The result of the above fragment is:
	<p class="output">%f=y		<p class="output">%f=y
	%f=y		%f=y
	z is not a foo enumeration string value		z is not a foo enumeration string value
	1 is not a foo enumeration x attribute value		1 is not a foo enumeration x attribute value
	%f=y		%f=y
	*** 1 CANCELLING REQUEST: MSIR.0750: Class Foo, function FromOrdinal:		*** 1 CANCELLING REQUEST: MSIR.0750: Class Foo, function FromOrdinal:
	InvalidValue exception: 3 is not a valid ordinal number for class foo ...		InvalidValue exception: 3 is not a valid ordinal number for class foo ...
Line 57:		Line 56:
	<li>[[InvalidValue methods syntax]] is a single page that contains the syntax diagrams of all the methods in the class. </li>		<li>[[InvalidValue methods syntax]] is a single page that contains the syntax diagrams of all the methods in the class. </li>
	</ul>		</ul>


	==New constructor==		==New constructor==

JAL: link repair

2014-11-18T21:27:20Z

link repair

New page

__NOTOC__
An <var>InvalidValue</var> exception indicates that a given value is not associated with a given enumeration. For example:
<p class="code">enumeration foo
public
attribute x is float inverse fromX
value y (3)
allow ordinal
end public
end enumeration
%f is enumeration foo
%f = fromString('Y')
printText {~=%f}
%f = fromX(3)
printText {~=%f}
try
%f = fromString('z')
catch invalidValue
print 'z is not a foo enumeration string value'
end try
try
%f = fromX(1)
catch invalidValue
print '1 is not a foo enumeration x attribute value'
end try
%f = fromOrdinal(1)
printText {~=%f}
%f = fromOrdinal(3)
</p>
The result of the above fragment is:
<p class="output">%f=y
%f=y
z is not a foo enumeration string value
1 is not a foo enumeration x attribute value
%f=y
*** 1 CANCELLING REQUEST: MSIR.0750: Class Foo, function FromOrdinal:
InvalidValue exception: 3 is not a valid ordinal number for class foo ...
</p>
The <var>InvalidValue</var> exception class has no properties. It is simply a notification that a valid attempt found no values that matched the given string or number.

To produce an <var>InvalidValue</var> exception yourself, you typically use a <var class="product">User Language</var> <var>[[Exceptions#Using the Throw statement|Throw]]</var> statement with an <var>InvalidValue</var> <var>[[New_(InvalidValue_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>InvalidValue</var> exception:
<p class="code">throw %(invalidValue):new
</p>

Remember that you catch an exception with the <var>[[Exceptions#Catch statement|Catch]]</var> statement; if an exception condition occurs outside a
<var>Catch</var> for it, the request is cancelled.

The <var>InvalidValue</var> class is available as of <var class="product">[[Sirius Mods]]</var> version 7.8.

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

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

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

This <var>Constructor</var> generates an instance of an <var>[[InvalidValue_class|InvalidValue]]</var> exception. The <var>New</var> method format follows:

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

====Syntax terms====
<table class="syntaxTable">
<tr><th>%invalidValue</th>
<td>A reference to an instance of an <var>InvalidValue</var> object. </td></tr>
<tr><th><var>[%(InvalidValue):]</var></th>
<td>The 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 an <var>InvalidValue</var> <var>Constructor</var>.</td></tr>
</table>

===Usage notes===
<ul>
<li>As described in [[Object variables#Using New or other Constructors|Using New or other Constructors]], <var>New</var> can be invoked with no object, with an explicit class name, or with an object variable in the class, even if that object is <var>Null</var>:<p class="code">%invalid = new

%invalid = %(InvalidValue):new

%invalid = %invalid:new
</p>
</ul>
[[Category:System exception classes]]

Dme at 20:21, 30 September 2012

2012-09-30T20:21:50Z

← Older revision		Revision as of 20:21, 30 September 2012
Line 5:		Line 5:
	public		public
	attribute x is float inverse fromX		attribute x is float inverse fromX
	value y (3)		value y (3)
			allow ordinal
	end public		end public
	end enumeration		end enumeration
Line 22:		Line 23:
	catch invalidValue		catch invalidValue
	print '1 is not a foo enumeration x attribute value'		print '1 is not a foo enumeration x attribute value'
	end try		end try
			%f = fromOrdinal(1)
			printText {~=%f}
			%f = fromOrdinal(3)
	</p>		</p>
	The result of the above fragment is:		The result of the above fragment is:
	<p class="output">%f=y		<p class="output"><nowiki>%f=y
	%f=y		%f=y
	z is not a foo enumeration string value		z is not a foo enumeration string value
	1 is not a foo enumeration x attribute value		1 is not a foo enumeration x attribute value
	</p>		%f=y
			*** 1 CANCELLING REQUEST: MSIR.0750: Class Foo, function FromOrdinal:
			InvalidValue exception: 3 is not a valid ordinal number for class foo ...
			</nowiki></p>
	The <var>InvalidValue</var> exception class has no properties. It is simply a notification that a valid attempt found no values that matched the given string or number.		The <var>InvalidValue</var> exception class has no properties. It is simply a notification that a valid attempt found no values that matched the given string or number.

Dme at 19:59, 30 September 2012

2012-09-30T19:59:30Z

@@ Line 1: / Line 1: @@
 <!-- InvalidValue class -->
 __NOTOC__
-An <var>InvalidValue</var> exception indicates that a given value is not associated with a given enumeration. This exception class has no properties. It is simply a notification that a valid attempt found no values that matched the given string or number.
+An <var>InvalidValue</var> exception indicates that a given value is not associated with a given enumeration. For example:
 To produce an <var>InvalidValue</var> exception yourself, you typically use a <var class="product">User Language</var> <var>[[Exceptions#Using the Throw statement|Throw]]</var> statement with an <var>InvalidValue</var> <var>[[New_(InvalidValue_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>InvalidValue</var> exception:

Dme at 19:46, 30 September 2012

2012-09-30T19:46:43Z

← Older revision		Revision as of 19:46, 30 September 2012
Line 1:		Line 1:
	<!-- InvalidValue class -->		<!-- InvalidValue class -->
	__NOTOC__		__NOTOC__
	~~The~~ <var>InvalidValue</var> exception ~~class describes an exception~~ associated with ~~not finding an expected value~~. This exception class has no properties. It is simply a notification that a valid attempt found no values that matched the given string or number.		An <var>InvalidValue</var> exception indicates that a given value is not associated with a given enumeration. This exception class has no properties. It is simply a notification that a valid attempt found no values that matched the given string or number.

	To produce an <var>InvalidValue</var> exception yourself, you typically use a <var class="product">User Language</var> <var>[[Exceptions#Using the Throw statement\|Throw]]</var> statement with an <var>InvalidValue</var> <var>[[New_(InvalidValue_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>InvalidValue</var> exception:		To produce an <var>InvalidValue</var> exception yourself, you typically use a <var class="product">User Language</var> <var>[[Exceptions#Using the Throw statement\|Throw]]</var> statement with an <var>InvalidValue</var> <var>[[New_(InvalidValue_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>InvalidValue</var> exception:

Alex at 03:11, 4 September 2012

2012-09-04T03:11:24Z

← Older revision		Revision as of 03:11, 4 September 2012
Line 1:		Line 1:
	<!-- InvalidValue class -->		<!-- InvalidValue class -->
	__NOTOC__		__NOTOC__
	The <var>InvalidValue</var> exception class describes an exception associated with not finding an expected value. This exception class has no properties. It is simply a notification that a valid attempt found no values that matched the given string.		The <var>InvalidValue</var> exception class describes an exception associated with not finding an expected value. This exception class has no properties. It is simply a notification that a valid attempt found no values that matched the given string or number.

	To produce an <var>InvalidValue</var> exception yourself, you typically use a <var class="product">User Language</var> <var>[[Exceptions#Using the Throw statement\|Throw]]</var> statement with an <var>InvalidValue</var> <var>[[New_(InvalidValue_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>InvalidValue</var> exception:		To produce an <var>InvalidValue</var> exception yourself, you typically use a <var class="product">User Language</var> <var>[[Exceptions#Using the Throw statement\|Throw]]</var> statement with an <var>InvalidValue</var> <var>[[New_(InvalidValue_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>InvalidValue</var> exception:

JAL2: /* New constructor */

2012-08-07T17:54:50Z

New constructor

← Older revision		Revision as of 17:54, 7 August 2012
Line 34:		Line 34:
	<tr><th>%invalidValue</th>		<tr><th>%invalidValue</th>
	<td>A reference to an instance of an <var>InvalidValue</var> object. </td></tr>		<td>A reference to an instance of an <var>InvalidValue</var> object. </td></tr>
	<tr><th><var>[%(InvalidValue)]</var></th>		<tr><th><var>[%(InvalidValue):]</var></th>
	<td>The 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 an <var>InvalidValue</var> <var>Constructor</var>.</td></tr>		<td>The 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 an <var>InvalidValue</var> <var>Constructor</var>.</td></tr>
	</table>		</table>

JAL2 at 19:31, 14 May 2012

2012-05-14T19:31:04Z

← Older revision		Revision as of 19:31, 14 May 2012
Line 13:		Line 13:

	<h2>The InvalidValue methods</h2>		<h2>The InvalidValue methods</h2>
	{{:List of InvalidValue methods}}		{{Template:List of InvalidValue methods}}

	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:

JAL2 at 00:40, 10 February 2012

2012-02-10T00:40:08Z

← Older revision		Revision as of 00:40, 10 February 2012
Line 1:		Line 1:
	<!-- InvalidValue class -->		<!-- InvalidValue class -->
	__NOTOC__		__NOTOC__
	The <var>InvalidValue</var> exception class describes an exception associated with not finding an ~~expectedvalue~~. This exception class has no properties. It is simply a notification that a valid attempt found no values that matched the given string.		The <var>InvalidValue</var> exception class describes an exception associated with not finding an expected value. This exception class has no properties. It is simply a notification that a valid attempt found no values that matched the given string.

	To produce an <var>InvalidValue</var> exception yourself, you typically use a <var class="product">User Language</var> <var>[[Exceptions#Using the Throw statement\|Throw]]</var> statement with an <var>InvalidValue</var> <var>[[New_(InvalidValue_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>InvalidValue</var> exception:		To produce an <var>InvalidValue</var> exception yourself, you typically use a <var class="product">User Language</var> <var>[[Exceptions#Using the Throw statement\|Throw]]</var> statement with an <var>InvalidValue</var> <var>[[New_(InvalidValue_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>InvalidValue</var> exception:

JAL2 at 00:05, 10 February 2012

2012-02-10T00:05:35Z

← Older revision		Revision as of 00:05, 10 February 2012
Line 3:		Line 3:
	The <var>InvalidValue</var> exception class describes an exception associated with not finding an expectedvalue. This exception class has no properties. It is simply a notification that a valid attempt found no values that matched the given string.		The <var>InvalidValue</var> exception class describes an exception associated with not finding an expectedvalue. This exception class has no properties. It is simply a notification that a valid attempt found no values that matched the given string.

	To produce an <var>InvalidValue</var> exception yourself, you typically use a <var class="product">User Language</var> <var>[[Throw]]</var> statement with an <var>InvalidValue</var> <var>[[New_(InvalidValue_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>InvalidValue</var> exception:		To produce an <var>InvalidValue</var> exception yourself, you typically use a <var class="product">User Language</var> <var>[[Exceptions#Using the Throw statement\|Throw]]</var> statement with an <var>InvalidValue</var> <var>[[New_(InvalidValue_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>InvalidValue</var> exception:
	<p class="code">throw %(invalidValue):new		<p class="code">throw %(invalidValue):new
	</p>		</p>

	Remember that you catch an exception with the <var>[[Catch statement\|Catch]]</var> statement; if an exception condition occurs outside a		Remember that you catch an exception with the <var>[[Exceptions#Catch statement\|Catch]]</var> statement; if an exception condition occurs outside a
	<var>Catch</var> for it, the request is cancelled.		<var>Catch</var> for it, the request is cancelled.