fcheckerr¶

Purpose¶

Gets the error status of a file.

Format¶

err = fcheckerr(fh)¶

Parameters:: fh (scalar) – file handle of a file opened with fopen().
Returns:: err (scalar) – error status equal to 1 if there has been a read or write error on a file, 0 otherwise.

Examples¶

// Create a file name with full path
fname = getGAUSSHome() $+ "startup";

// Open a file handle for
// reading only from the file
fh = fopen(fname, "r");

// Try to write to the file using a read-only file handle
ret = fputs(fh, "alpha,beta,gamma");

// Check to see if there was a file i/o error
if fcheckerr(fh);
    print "File write failed";
endif;

call close(fh);

After the above code, the program will print:

File write failed

Remarks¶

If you pass fcheckerr() the handle of a file opened with open (i.e., a dataset or matrix file), your program will terminate with a fatal error.

fclearerr