ERNUM
Syntax |
ERNUM |
Location |
QL ROM (post JM version) |
This function returns the error number of the last error which occurred. An error number is negative and can be returned by any program (SuperBASIC, jobs, M/C Toolkits,…). The equivalent error messages are the same on all of the implementations of SuperBASIC, although they are also supported in different languages (see the Appendix for other languages):
Error |
English message |
---|---|
-1 |
Not Complete |
-2 |
Invalid Job |
-3 |
Out of Memory |
-4 |
Out of Range |
-5 |
Buffer Full |
-6 |
Channel not Open |
-7 |
Not Found |
-8 |
Already Exists |
-9 |
In Use |
-10 |
End of File |
-11 |
Drive Full |
-12 |
Bad Name |
-13 |
Xmit Error |
-14 |
Format Failed |
-15 |
Bad Parameter |
-16 |
Bad or Changed Medium |
-17 |
Error in Expression |
-18 |
Overflow |
-19 |
Not Implemented Yet |
-20 |
Read Only |
-21 |
Bad Line |
NOTE
Jobs may return a positive error number. The meaning of such a number depends on the job. No error message will be reported.
SMS NOTE
The error messages have been redefined to try to make them more intelligent, they are now:
Error |
English message |
---|---|
-1 |
Incomplete |
-2 |
Invalid Job ID |
-3 |
Insufficient memory |
-4 |
Value out of range |
-5 |
Buffer full |
-6 |
Invalid channel ID |
-7 |
Not found |
-8 |
Already exists |
-9 |
Is in use |
-10 |
End of file |
-11 |
Medium is full |
-12 |
Invalid name |
-13 |
Transmission error |
-14 |
Format failed |
-15 |
Invalid parameter |
-16 |
Medium check failed |
-17 |
Error in expression |
-18 |
Arithmetic overflow |
-19 |
Not implemented |
-20 |
Write protected |
-21 |
Invalid syntax |
-22 |
Unknown message |
-23 |
Access denied |
Other errors are reported by the SBASIC interpreter, but these are not covered by ERNUM.
CROSS-REFERENCE
ERLIN returns the line number where the error occurred. ERNUM% is the same as this function. REPORT invokes an error message and WHEN ERRor can be used to trap errors. The ERR_XX functions are alternatives to ERNUM.