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