Portability Function: Returns the last error set by a run-time procedure.
Module: USE IFPORT
Syntax
result = GETLASTERRORQQ( )
Results
The result type is INTEGER(4). The result is the most recent error code generated by a run-time procedure.
Library functions that return a logical or integer value sometimes also provide an error code that identifies the cause of errors. GETLASTERRORQQ retrieves the most recent error message. The error constants are defined in IFPORT.F90. The following table shows some library routines and the errors each routine produces:
| Library routine | Errors produced |
|---|---|
| BEEPQQ | no error |
| BSEARCHQQ | ERR$INVAL |
| CHANGEDIRQQ | ERR$NOMEM, ERR$NOENT |
| CHANGEDRIVEQQ | ERR$INVAL, ERR$NOENT |
| COMMITQQ | ERR$BADF |
| DELDIRQQ | ERR$NOMEM, ERR$ACCES, ERR$NOENT |
| DELFILESQQ | ERR$NOMEM, ERR$ACCES, ERR$NOENT, ERR$INVAL |
| FINDFILEQQ | ERR$NOMEM, ERR$NOENT |
| FULLPATHQQ | ERR$NOMEM, ERR$INVAL |
| GETCHARQQ | no error |
| GETDRIVEDIRQQ | ERR$NOMEM, ERR$RANGE |
| GETDRIVESIZEQQ | ERR$INVAL, ERR$NOENT |
| GETDRIVESQQ | no error |
| GETENVQQ | ERR$NOMEM, ERR$NOENT |
| GETFILEINFOQQ | ERR$NOMEM, ERR$NOENT, ERR$INVAL |
| GETLASTERRORQQ | no error |
| GETSTRQQ | no error |
| MAKEDIRQQ | ERR$NOMEM, ERR$ACCES, ERR$EXIST, ERR$NOENT |
| PACKTIMEQQ | no error |
| PEEKCHARQQ | no error |
| RENAMEFILEQQ | ERR$NOMEM, ERR$ACCES, ERR$NOENT, ERR$XDEV |
| RUNQQ | ERR$NOMEM, ERR$2BIG, ERR$INVAL, ERR$NOENT, ERR$NOEXEC |
| SETERRORMODEQQ | no error |
| SETENVQQ | ERR$NOMEM, ERR$INVAL |
| SETFILEACCESSQQ | ERR$NOMEM, ERR$INVAL, ERR$ACCES |
| SETFILETIMEQQ | ERR$NOMEM, ERR$ACCES, ERR$INVAL, ERR$MFILE, ERR$NOENT |
| SLEEPQQ | no error |
| SORTQQ | ERR$INVAL |
| SPLITPATHQQ | ERR$NOMEM, ERR$INVAL |
| SYSTEMQQ | ERR$NOMEM, ERR$2BIG, ERR$NOENT, ERR$NOEXEC |
| UNPACKTIMEQQ | no error |
Compatibility
CONSOLE STANDARD GRAPHICS QUICKWIN GRAPHICS DLL LIB