[doc] misc. fix & improvements
[scilab.git] / scilab / modules / core / help / ru_RU / error_handling / lasterror.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2 <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="lasterror" xml:lang="ru">
3     <refnamediv>
4         <refname>lasterror</refname>
5         <refpurpose>получение последнего записанного сообщения об ошибке</refpurpose>
6     </refnamediv>
7     <refsynopsisdiv>
8         <title>Синтаксис</title>
9         <synopsis>
10             str=lasterror( [opt] )
11             [str,n]=lasterror([opt])
12             [str,n,line,func]=lasterror([opt])
13         </synopsis>
14     </refsynopsisdiv>
15     <refsection>
16         <title>Аргументы</title>
17         <variablelist>
18             <varlistentry>
19                 <term>str</term>
20                 <listitem>
21                     <para>
22                         вектор символьных строк или пустая матрица. Последнее записанное сообщение
23                         об ошибке.
24                     </para>
25                 </listitem>
26             </varlistentry>
27             <varlistentry>
28                 <term>n</term>
29                 <listitem>
30                     <para>целое число, 0 или номер последней записанной ошибки.</para>
31                 </listitem>
32             </varlistentry>
33             <varlistentry>
34                 <term>line</term>
35                 <listitem>
36                     <para>целое число, 0 или последний записанный номер строки функции.</para>
37                 </listitem>
38             </varlistentry>
39             <varlistentry>
40                 <term>func</term>
41                 <listitem>
42                     <para>строка, имя последней записанной функции.</para>
43                 </listitem>
44             </varlistentry>
45             <varlistentry>
46                 <term>opt</term>
47                 <listitem>
48                     <para>логическое значение, если %t, то записанное сообщение очищено. По умолчанию %t.
49                     </para>
50                 </listitem>
51             </varlistentry>
52         </variablelist>
53     </refsection>
54     <refsection>
55         <title>Описание</title>
56         <para>
57             Каждый раз, когда возникает ошибка, регулятор ошибок Scilab записывает её во
58             внутреннюю таблицу (удерживается только последняя). Функция
59             <literal>lasterror</literal> позволяет получить сообщение, номер ошибки,
60             текущую функцию (если есть) и номер текущей строки в текущей функции  из этой таблицы.
61         </para>
62         <para>
63             Указанный номер строки является номером <emphasis>физической</emphasis> строки, в
64             которой произошла последняя ошибка. Заметьте, что версии Scilab до 5.0
65             использовали для указания <emphasis>логический</emphasis> номер строки последней ошибки.
66             Разница имеется только если функция, в которой произошла ошибка, содержит
67             <emphasis>продолженные строки</emphasis> (смотрите <link linkend="dot">dot</link>)
68             перед местом возникновения ошибки.
69         </para>
70         <para>
71             Эта функция особенно полезна при использовании <link linkend="execstr">execstr</link>.
72         </para>
73         <para>
74             Записанное сообщение об ошибке может удерживаться для дальнейшего вызова <literal>lasterror</literal>, с помощью
75             <literal>lasterror(%f)</literal>.
76         </para>
77     </refsection>
78     <refsection>
79         <title>Примеры</title>
80         <programlisting role="example"><![CDATA[
81 ierr=execstr('a=zzzzzzz','errcatch')
82 if ierr>0 then
83   disp(lasterror())
84 end
85  ]]></programlisting>
86     </refsection>
87     <refsection role="see also">
88         <title>Смотрите также</title>
89         <simplelist type="inline">
90             <member>
91                 <link linkend="execstr">execstr</link>
92             </member>
93             <member>
94                 <link linkend="error">error</link>
95             </member>
96             <member>
97                 <link linkend="errclear">errclear</link>
98             </member>
99             <member>
100                 <link linkend="edit_error">edit_error</link>
101             </member>
102         </simplelist>
103     </refsection>
104 </refentry>