InvalidValue class: Difference between revisions
mNo edit summary |
mNo edit summary |
||
Line 26: | Line 26: | ||
<h3>Syntax</h3> | <h3>Syntax</h3> | ||
{{Template:InvalidValue:New syntax}} | {{Template:InvalidValue:New syntax}} | ||
<h4>Syntax terms</h4> | <h4>Syntax terms</h4> | ||
<table class="syntaxTable"> | <table class="syntaxTable"> | ||
<tr><th>%invalidValue</th> | <tr><th>%invalidValue</th> | ||
<td>A reference to an instance of an <var>InvalidValue</var> object. | <td>A reference to an instance of an <var>InvalidValue</var> object. </td></tr> | ||
</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>.</td></tr> | <td>The class name in parentheses denotes a <var>[[Notation conventions for methods#Constructors|Constructor]]</var>. </td></tr> | ||
</table> | |||
==Example== | ==Example== |
Revision as of 21:37, 5 August 2011
The InvalidValue exception class describes an exception associated with finding non-hexadecimal data where hexadecimal data was expected, usually when translating the hexadecimal data to something else.
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 with the position set to 1
:
throw %(invalidValue):new(position=1)
The InvalidValue methods
The following are the available InvalidValue class methods.
Method | Description |
---|---|
New | Create a new InvalidValue object |
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. |
Example
The following statements catch an InvalidValue exception and print its position:
%target is object InvalidValue try %myobject:mymethod catch InvalidValue to %target print '%target is ' %target:Position end try