mirror of
https://github.com/QB64Official/qb64.git
synced 2024-09-28 11:17:47 +00:00
44 lines
1.2 KiB
Text
44 lines
1.2 KiB
Text
The [[ERR]] function returns the last QBasic error code number.
|
|
|
|
|
|
{{PageSyntax}}
|
|
: {{Parameter|errorNum%}} = [[ERR]]
|
|
|
|
|
|
{{PageDescription}}
|
|
* If there is no error, the function returns 0
|
|
* Can be used in an error handling routine to report the last error code number.
|
|
|
|
|
|
{{PageExamples}}
|
|
''Example:'' Simulating an error to test a program error handler that looks for a "Subscript out of range" error.
|
|
{{CodeStart}} '' ''
|
|
{{Cl|ON ERROR}} {{Cl|GOTO}} handler
|
|
|
|
{{Cl|IF...THEN|IF}} x = 0 {{Cl|THEN}} {{Cl|ERROR}} 111 'simulate an error code that does not exist
|
|
x = x + 1
|
|
{{Cl|IF...THEN|IF}} x {{Cl|THEN}} {{Cl|ERROR}} 9 'simulate array boundary being exceeded
|
|
|
|
{{Cl|END}}
|
|
|
|
handler:
|
|
{{Cl|PRINT}} {{Cl|ERR}}, {{Cl|_ERRORLINE}}
|
|
{{Cl|BEEP}}
|
|
{{Cl|IF...THEN|IF}} {{Cl|ERR}} = 9 {{Cl|THEN}}
|
|
{{Cl|PRINT}} "The program has encountered an error and needs to close! Press a key!"
|
|
K$ = {{Cl|INPUT$}}(1)
|
|
{{Cl|SYSTEM}}
|
|
{{Cl|END IF}}
|
|
{{Cl|RESUME}} {{Cl|NEXT}} 'RESUME can only be used in error handlers '' ''
|
|
{{CodeEnd}}
|
|
|
|
|
|
{{PageSeeAlso}}
|
|
* [[ON ERROR]], [[RESUME]]
|
|
* [[ERL]]
|
|
* [[_ERRORLINE]], [[_INCLERRORLINE]], [[_INCLERRORFILE$]], [[_ERRORMESSAGE$]]
|
|
* [[ERROR]]
|
|
* [[ERROR Codes]]
|
|
|
|
|
|
{{PageNavigation}}
|