Scilab Website | Contribute with GitLab | Mailing list archives | ATOMS toolboxes
Scilab Online Help
5.3.3 - English

Change language to:
Français - 日本語 - Português

Please note that the recommended version of Scilab is 2025.0.0. This page might be outdated.
See the recommended documentation of this function

Scilab help >> Files : Input/Output functions > merror

merror

tests the file access errors indicator

Calling Sequence

err = merror([fd])

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

Arguments

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 — reset binary file access errors
  • mclose — close an opened file
  • mopen — open a file
  • mput — writes byte or word in a given binary format
  • mget — reads byte or word in a given binary format and convert to double
  • mgetstr — read a character string from a file
  • mputstr — write a character string in a file
  • meof — check if end of file has been reached
  • mseek — set current position in binary file.
  • mtell — binary file management
<< meof Files : Input/Output functions mfprintf >>

Copyright (c) 2022-2024 (Dassault Systèmes)
Copyright (c) 2017-2022 (ESI Group)
Copyright (c) 2011-2017 (Scilab Enterprises)
Copyright (c) 1989-2012 (INRIA)
Copyright (c) 1989-2007 (ENPC)
with contributors
Last updated:
Wed Oct 05 12:09:59 CEST 2011