Difference between revisions of "FERROR()"

From Recital Documentation Wiki
Jump to: navigation, search
 
Line 44: Line 44:
 
[[Category:Documentation]]
 
[[Category:Documentation]]
 
[[Category:Functions]]
 
[[Category:Functions]]
 +
[[Category:ASCII File Access]]
 +
[[Category:ASCII File Access Functions]]

Revision as of 13:49, 2 June 2009

Class

ASCII File Access


Purpose

Function to return the status of the last text-file operation


Syntax

FERROR()


See Also

FCLOSE(), FCREATE(), FGETS(), FOPEN(), FPUTS(), FREADSTR(), FWRITE(), MEMOREAD(), MEMOWRITE(), TEXTEDIT()


Description

The FERROR() function returns an integer representing the status of the last text file operation. It returns –1 for failure, 0 for success. This function should always be used in conjunction with the other text file functions to check for errors.


Example

use accounts
fp=fopen("existing.file")
if ferror()=-1
    dialog box "The file could not be opened."
else
    string = freadstr(fp,80)
    do while not empty(string)
        ? string
        string = freadstr(fp,80)
    enddo
    ?
    fclose(fp)
    if ferror()=-1
        dialog box "The file could not be closed."
    endif
endif


Products

Recital Database Server, Recital Mirage Server, Recital Terminal Developer