Erd_Dialog - Texas Instruments TI-89 Developer's Manual

Appendix A: System Routines — Error Handling

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
bGoto — TRUE means add [Enter=GOTO] button to dialog box. FALSE
Outputs: Returns TRUE if the [Enter=GOTO] button is visible and the user pressed
¸. Otherwise returns FALSE.
errno must be the number of a system error — do not use this routine to
Assumptions:
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);
/* Execution returns here after user presses [ENTER] or [ESC] */
TI-89 / TI-92 Plus Developer Guide
— Number of system error message.
means omit the [Enter=GOTO] button.
/* display ERROR: MEMORY dialog box */
Not for Distribution
455
Beta Version January 26, 2001