Name

merror — tests the file access errors indicator

Calling Sequence

err = merror([fd])

[err,msg] = merror([fd])

Parameters

fd

scalar. The fd parameter returned by the function mopen. -1 stands for last opened file. Default value is -1.

err

scalar. returns the error status number errnum of the most recent file I/O operation associated with the specified file.

If the most recent I/O operation performed on the specified file was successful, the value of msg is empty and merror returns an err value of 0.

msg

string. returns the error string message.

Description

The function merror is used to tests the file access errors indicator. returning non-zero if it is set. The error indicator can only be reset by the mclearerr function.

A nonzero err indicates that an error occurred in the most recent file I/O operation. The value of message is a string that can contain information about the nature of the error. If the message is not helpful, consult the C run-time library manual for your host operating system for further details.

Examples

 
fd = mopen(TMPDIR +'/filetxt.txt','wt');
[err,msg] = merror(fd)
if (err <> 0) then 
  printf('Problem\n');
end
mclose(fd);

See Also

mclearerr, mclose, mopen, mput, mget, mgetstr, mputstr, meof, mseek, mtell