NAME 
classes/exception.pmc - Exception PMC
DESCRIPTION
This is the exception base class.
As we are still lacking objects,
this class is based on a SArray.
This will probably change.
An exception object has these attributes:
- 0
_message - Textual representation of the exception.
- 1
_type - The exception type, (see include/parrot/exceptions.h, except_type.pasm).
- 2
_severity - The severity of the exception, (see src/exceptions.h, except_severity.pasm).
- 3
_P5 - The contents of
REG_PMC(5). - 4
_return_cc - The return continuation.
Optional:
- 5
_C_file - The C code file in which the exception was raised.
- 6
_C_line - The line of C code on which the exception was raised.
- 7
_P_file - The PASM/PIR/Perl file in which the exception was raised.
- 8
_P_line - The line of PASM/PIR/Perl code on which the exception was raised.
- ...
- Any information attached by the HL. This shouldn't start with an underscore (that is reserved for Parrot's internal usage. These are stored as properties.
- Note: currently, HLL information must be indexed by number. Slots 9 and 10 are available for the HLL - This is subject to change.
When an exception handler is called,
the exception object is passed as REG_PMC(5),
the original contents of this register is in the exception object's _P5 attribute.
This is experimental code.
The enum_class of the Exception isn't fixed.
The interface isn't fixed.
Methods
void init()- Initializes the exception with default values.
STRING *get_string_keyed(PMC *key)- Returns the Parrot string value for
*key. The only current recognizedkeyis "_message". STRING *get_string()- Return the exception message.
INTVAL get_integer_keyed(PMC *key)- Returns the integer value for
*key. PMC *get_pmc_keyed(PMC *key)- Returns the PMC value for
*key. void set_string_keyed(PMC *key, STRING *value)- Sets the Parrot string value for
*key. void set_integer_keyed(PMC *key, INTVAL value)- Sets the integer value for
*key. void set_pmc_keyed(PMC *key, PMC *value)- Sets the PMC value for
*key. INTVAL is_equal(PMC *value)- Compare the passed in Exception with SELF.
Returns True if
SELFisavalue
HISTORY
Initial revision by leo 2003.07.10.
