Appendix A: System Routines — Error Handling
455
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
ERD_dialog
Declaration:
BOOL
ERD_dialog
(SSHORT
errno
, BOOL
bGoto
)
Category(ies):
Error Handling
Description:
Looks up and displays text of error message for error number
errno
in a
dialog box. This routine waits for the user to press
N
or
¸
to dismiss
the dialog box.
The error dialog box always displays an [ESC=CANCEL] button.
Additionally, the [Enter=GOTO] button is displayed if
bGoto
is TRUE. This
routine does not perform the actual transfer to the program editor if the
user presses
¸
.
This routine is the core of the user interface to the system error handler. It
is rarely necessary to call this routine directly.
ER_throwVar
is usually
adequate to handle error conditions.
Inputs:
errno
— Number of system error message.
bGoto
— TRUE means add [Enter=GOTO] button to dialog box. FALSE
means omit the [Enter=GOTO] button.
Outputs:
Returns TRUE if the [Enter=GOTO] button is visible and the user pressed
¸
. Otherwise returns FALSE.
Assumptions:
errno
must be the number of a system error — do not use this routine to
display application error messages.
Side Effects:
May cause heap compression.
Availability:
All versions of the TI
-
89 / TI
-
92 Plus.
TI
-
89 / TI
-
92 Plus
Differences:
None
See Also: ER_throwVar
Example:
ERD_dialog(ER_MEMORY, FALSE); /* display ERROR: MEMORY dialog box */
/* Execution returns here after user presses [ENTER] or [ESC] */