InvalidValue class: Difference between revisions

From m204wiki
Jump to navigation Jump to search
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 non-hexadecimal data where hexadecimal data was expected, usually when translating the hexadecimal data to something else.
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 with the position set to <code>1</code>:
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(position=1)
<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>
==Example==
The following statements catch an InvalidValue exception and print its position:
<p class="code">%target is object InvalidValue
[[try]] %myobject:mymethod
  [[catch]] InvalidValue to %target
  print '%target is ' %target:Position
end try
</p>


[[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.

MethodDescription
NewCreate a new InvalidValue object

See also

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.