InvalidValue class: Difference between revisions

From m204wiki
Jump to navigation Jump to search
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>
</td></tr></table>
</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.

MethodDescription
NewCreate a new InvalidValue object

The methods in the class are described in the subsections that follow. In addition:


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