mirror of
https://github.com/QB64Official/qb64.git
synced 2024-09-28 11:17:47 +00:00
41 lines
1.3 KiB
Markdown
41 lines
1.3 KiB
Markdown
The [_ERRORMESSAGE$](_ERRORMESSAGE$) function returns a human-readable description of the most recent runtime error, or the description of an arbitrary error code passed to it.
|
|
|
|
## Syntax
|
|
|
|
> e$ = [_ERRORMESSAGE$](_ERRORMESSAGE$)
|
|
> e$ = [_ERRORMESSAGE$](_ERRORMESSAGE$)(errorCode%)
|
|
|
|
## Description
|
|
|
|
* Used in program error troubleshooting.
|
|
* The message returned is identical to the message shown in the dialog box that appears if your program has no error handler. See [ERROR Codes](ERROR-Codes) for the full list of error codes and their messages.
|
|
|
|
## Example(s)
|
|
|
|
Using an error handler that ignores any error.
|
|
|
|
```vb
|
|
|
|
ON ERROR GOTO Errhandler
|
|
' Main module program error simulation code
|
|
ERROR 7 ' simulate an Out of Memory Error
|
|
PRINT "Error handled...ending program"
|
|
SLEEP 4
|
|
SYSTEM ' end of program code
|
|
|
|
Errhandler: 'error handler sub program line label
|
|
PRINT "Error"; ERR; "on program file line"; _ERRORLINE
|
|
PRINT "Description: "; _ERRORMESSAGE$; "."
|
|
BEEP ' warning beep
|
|
RESUME NEXT ' moves program to code following the error.
|
|
|
|
```
|
|
|
|
## See Also
|
|
|
|
* [ON ERROR](ON-ERROR)
|
|
* [_ERRORLINE](_ERRORLINE)
|
|
* [_INCLERRORLINE](_INCLERRORLINE), [_INCLERRORFILE$](_INCLERRORFILE$)
|
|
* [ERR](ERR), [ERL](ERL)
|
|
* [ERROR](ERROR)
|
|
* [ERROR Codes](ERROR-Codes)
|