1<?xml version="1.0" encoding="UTF-8"?>
2<!--
3 * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
4 * Copyright (C) 2008 - INRIA
5 * Copyright (C) 2009 - DIGITEO - Allan CORNET
6 *
7 * Copyright (C) 2012 - 2016 - Scilab Enterprises
8 *
9 * This file is hereby licensed under the terms of the GNU GPL v2.0,
10 * pursuant to article 5.3.4 of the CeCILL v.2.1.
11 * This file was originally licensed under the terms of the CeCILL v2.1,
12 * and continues to be available under such terms.
13 * For more information, see the COPYING file which you should have received
14 * along with this program.
15 *
16 -->
17<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns3="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="merror" xml:lang="ru">
18    <refnamediv>
19        <refname>merror</refname>
20        <refpurpose>проверяет индикатор ошибок доступа к файлу</refpurpose>
21    </refnamediv>
22    <refsynopsisdiv>
23        <title>Синтаксис</title>
24        <synopsis>
25            err = merror([fd])
26            [err, msg] = merror([fd])
27        </synopsis>
28    </refsynopsisdiv>
29    <refsection>
30        <title>Аргументы</title>
31        <variablelist>
32            <varlistentry>
33                <term>fd</term>
34                <listitem>
35                    <para>
36                        скаляр: параметр <varname>fd</varname> возвращённый функцией
37                        <function>mopen</function>, используемый в качестве файлового
38                        дескриптора. Для последнего открытого файла значение равно -1.
39                        Значение по умолчанию -1.
40                    </para>
41                </listitem>
42            </varlistentry>
43            <varlistentry>
44                <term>err</term>
45                <listitem>
46                    <para>
47                        скаляр: номер статуса ошибки самой последней операции ввода/вывода файла, связанная с указанным файлом.
48                    </para>
49                    <para>
50                        Если самая последняя операция ввода/вывода, выполненная для
51                        указанного файла, была успешной, то значение
52                        <varname>msg</varname> пустое и <function>merror</function>
53                        возвращает нулевое значение <varname>err</varname>.
54                    </para>
55                </listitem>
56            </varlistentry>
57            <varlistentry>
58                <term>msg</term>
59                <listitem>
60                    <para>строка: строковое сообщение об ошибке.</para>
61                </listitem>
62            </varlistentry>
63        </variablelist>
64    </refsection>
65    <refsection>
66        <title>Описание</title>
67        <para>
68            Функция <function>merror</function> используется для проверки индикатора ошибок доступа к файлу, возвращая ненулевое значение, если она установлена. Индикатор ошибки может быть сброшен только с помощью функции <function>mclearerr</function>.
69        </para>
70        <para>
71            Ненулевое значение <varname>err</varname> указывает на то, что произошла ошибка в самой последней операции ввода-вывода файла. Значение сообщения является строковым и может содержать информацию о природе ошибки. Если сообщение не помогает, то обратитесь за справкой в руководство по C-библиотекам времени запуска для вашей операционной системы.
72        </para>
73    </refsection>
74    <refsection>
75        <title>Примеры</title>
76        <programlisting role="example"><![CDATA[
77fd = mopen(TMPDIR +'/filetxt.txt','wt');
78[err,msg] = merror(fd)
79if (err <> 0) then
80  mprintf('Problem\n');
81end
82mclose(fd);
83 ]]></programlisting>
84    </refsection>
85    <refsection role="see also">
86        <title>Смотрите также</title>
87        <simplelist type="inline">
88            <member>
89                <link linkend="mclearerr">mclearerr</link>
90            </member>
91            <member>
92                <link linkend="mclose">mclose</link>
93            </member>
94            <member>
95                <link linkend="mopen">mopen</link>
96            </member>
97            <member>
98                <link linkend="mput">mput</link>
99            </member>
100            <member>
101                <link linkend="mget">mget</link>
102            </member>
103            <member>
104                <link linkend="mgetstr">mgetstr</link>
105            </member>
106            <member>
107                <link linkend="mputstr">mputstr</link>
108            </member>
109            <member>
110                <link linkend="meof">meof</link>
111            </member>
112            <member>
113                <link linkend="mseek">mseek</link>
114            </member>
115            <member>
116                <link linkend="mtell">mtell</link>
117            </member>
118        </simplelist>
119    </refsection>
120</refentry>
121
122