InvalidValue class
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