InvalidValue class: Difference between revisions
| mNo edit summary | mNo edit summary | ||
| Line 1: | Line 1: | ||
| <!-- InvalidValue class --> | <!-- InvalidValue class --> | ||
| __NOTOC__ | __NOTOC__ | ||
| The <var>InvalidValue</var> exception class describes an exception associated with finding  | 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>[[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> | ||
| The <var>InvalidValue</var> class is available as of <var class="product">[[Category:System exception classes]]</var> version 7.8. | |||
| <h2>The InvalidValue methods</h2> | <h2>The InvalidValue methods</h2> | ||
| Line 34: | Line 35: | ||
| <td>The class name in parentheses denotes a <var>[[Notation conventions for methods#Constructors|Constructor]]</var>. </td></tr> | <td>The class name in parentheses denotes a <var>[[Notation conventions for methods#Constructors|Constructor]]</var>. </td></tr> | ||
| </table> | </table> | ||
| [[Category:System exception classes]] | [[Category:System exception classes]] | ||
Revision as of 22:34, 5 August 2011
The InvalidValue 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 InvalidValue exception yourself, you typically use a User Language Throw statement with an InvalidValue New 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 InvalidValue exception:
throw %(invalidValue):new
The InvalidValue class is available as of version 7.8.
The InvalidValue methods
The following are the available InvalidValue class methods.
| Method | Description | 
|---|---|
| New | Create a new InvalidValue object | 
See also
The methods in the class are described in the subsections that follow. In addition:
- "Notation conventions for methods" has information about the conventions followed.
- "InvalidValue methods syntax" is a single page that contains the syntax diagrams of all the methods in the class.
New constructor
Create a new InvalidHexData object (InvalidHexData class)
This Constructor generates an instance of an InvalidHexData exception. As shown below, the required argument of the New method is a setting of the Position property.
Syntax
%invalidValue = [%(InvalidValue):]New
Syntax terms
| %invalidValue | A reference to an instance of an InvalidValue object. | 
|---|---|
| %(InvalidValue) | The class name in parentheses denotes a Constructor. |