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

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

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

Scilab manual >> 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);
<< meof Files : Input/Output functions mfprintf >>

Copyright (c) 2022-2023 (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 Jan 26 16:23:43 CET 2011