Texas Instruments TI-89 - Er_Throwvar

454
Appendix A: System Routines — Error Handling
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
ER_throwVar
Declaration:
void
ER_throwVar
(SINT
errorCode
)
Category(ies):
Error Handling
Description:
This routine throws an exception to be caught in the
ONERR
or
FINALLY
section of an enclosing
TRY
block. See chapter
10. Error Handling
for a
complete discussion of throwing and catching exceptions.
Inputs:
errorCode
— Error number signifying cause of exception. This can be a
predefined error number (see “ER_” macros) or an
application-specific error number with corresponding error
string in the app’s frame.
Outputs:
None. This routine never returns — execution resumes at the
ONERR
or
FINALLY
section of the enclosing
TRY
block.
Assumptions:
Do not throw errors while processing events CM_START, CM_ACTIVATE,
CM_FOCUS, CM_UNFOCUS, CM_DEACTIVATE, CM_QUIT,
CM_WPAINT, CM_INSTALL, CM_UNINSTALL, CM_PACK, or
CM_UNPACK. See
EV_errorCode
and section
10.2 Delayed Error
Messages
for an alternative to throwing errors.
Side Effects:
None
Availability:
All versions of the TI
-
89 / TI
-
92 Plus.
TI
-
89 / TI
-
92 Plus
Differences:
None
See Also: ER_throw, ER_throwFrame, EV_errorCode, FINALLY, ONERR, TRY
Example:
TRY
HANDLE h;
h = HeapAlloc(A_BIG_BUFFER);
if (h == H_NULL)
ER_throwVar(ER_MEMORY);
.
.
.
HeapFree(h)
ONERR
/* Do something about low memory condition */
.
.
.
ENDTRY