2a280f634dba3c000e273caa2abadfc4c164924b
[scilab.git] / scilab / modules / string / help / ru_RU / evstr.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2 <!--
3  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
4  *
5  * Copyright (C) 2012 - 2016 - Scilab Enterprises
6  *
7  * This file is hereby licensed under the terms of the GNU GPL v2.0,
8  * pursuant to article 5.3.4 of the CeCILL v.2.1.
9  * This file was originally licensed under the terms of the CeCILL v2.1,
10  * and continues to be available under such terms.
11  * For more information, see the COPYING file which you should have received
12  * along with this program.
13  *
14  -->
15 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
16         xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns5="http://www.w3.org/1999/xhtml"
17         xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook"
18         xmlns:scilab="http://www.scilab.org" xml:id="evstr" xml:lang="ru">
19     <refnamediv>
20         <refname>evstr</refname>
21         <refpurpose>вычисление выражений</refpurpose>
22     </refnamediv>
23     <refsynopsisdiv>
24         <title>Синтаксис</title>
25         <synopsis>
26             H = evstr(M)
27             H = evstr(list(M, subExpr))
28             [H, ierr] = evstr(..)
29         </synopsis>
30     </refsynopsisdiv>
31     <refsection>
32         <title>Аргументы</title>
33         <variablelist>
34           <varlistentry>
35               <term>M</term>
36               <listitem>
37                 <para>матрица символьных строк.</para>
38               </listitem>
39           </varlistentry>
40           <varlistentry>
41             <term>subExpr</term>
42             <listitem>
43               <para>вектор символьных строк.</para>
44             </listitem>
45           </varlistentry>
46           <varlistentry>
47             <term>H</term>
48             <listitem>
49               <para>матрица.</para>
50             </listitem>
51           </varlistentry>
52           <varlistentry>
53             <term>ierr</term>
54             <listitem>
55               <para>целое число, указатель ошибки.</para>
56             </listitem>
57           </varlistentry>
58         </variablelist>
59     </refsection>
60     <refsection>
61         <title>Описание</title>
62         <para>
63             Возвращает результат вычисления матрицы символьных строк
64             <varname>M</varname>. Каждый элемент матрицы должен определять
65             корректное Scilab-выражение.
66         </para>
67         <para>
68             Если вычисление выражения <varname>M</varname> ведёт к ошибке, то в
69             случае с одним возвращаемым значением, <code>H = evstr(M)</code>,
70             возникает ошибка как обычно. В случае с двумя возвращаемыми
71             значениями, <code>[H,ierr] = evstr(M)</code>, ошибки не возникает,
72             но возвращается номер ошибки в <varname>ierr</varname>.
73         </para>
74         <para>
75             Если указан список, то <varname>subExpr</varname>
76             вектор символьных строк, который определяет подвыражения, которые
77             вычисляются до вычисления <varname>M</varname>. К этим
78             подвыражениям следует обращаться как <literal>%(k)</literal> в
79             <varname>M</varname>, где <literal>k</literal> - это индекс
80             подвыражения в <varname>Subexp</varname>.
81         </para>
82         <para>
83             <code>evstr('a = 1')</code> не корректно (вместо этого используйте
84             функцию <function>execstr</function>).
85         </para>
86         <para>
87             <literal>Nan</literal>, <literal>NaN</literal> будут
88             интерпретироваться как <constant>%nan</constant>.
89         </para>
90         <para>
91             <literal>Inf</literal> будет интерпретироваться как <constant>%inf</constant>.
92         </para>
93         <warning>
94             <varname>Z</varname> не должно содержать знаков продолжения (..).
95         </warning>
96     </refsection>
97     <refsection>
98         <title>Примеры</title>
99         <programlisting role="example"><![CDATA[
100 a = 1; b = 2;
101 Z = ['a', 'b'] ;
102 evstr(Z)
103 Z = list(['%(1)','%(1)-%(2)'],['a+1','b+1']);
104 evstr(Z)
105
106 evstr('NaN'), evstr('Inf')
107
108 //Вариант с двумя возвращаемыми значениями
109 [H, ierr] = evstr(Z) // ошибки нет
110 Z = ['a', 'b', 'c'] ;// переменная c не определена
111 [H, ierr] = evstr(Z) // error 4: Неизвестная переменная: c
112 ]]>     </programlisting>
113     </refsection>
114     <refsection role="see also">
115         <title>Смотрите также</title>
116         <simplelist type="inline">
117             <member>
118                 <link linkend="execstr">execstr</link>
119             </member>
120             <member>
121                 <link linkend="sci2exp">sci2exp</link>
122             </member>
123             <member>
124                 <link linkend="strtod">strtod</link>
125             </member>
126             <member>
127                 <link linkend="brackets">конкатенация</link>
128             </member>
129         </simplelist>
130     </refsection>
131     <refsection role="history">
132         <title>История</title>
133         <revhistory>
134             <revision>
135                 <revnumber>5.3.0</revnumber>
136                 <revdescription>
137                 <literal>"Nan"</literal> and <literal>"NaN"</literal> are now parsed as <literal>%nan</literal>.
138                 <literal>"Inf"</literal> and <literal>"INF"</literal> are now parsed as <literal>%inf</literal>.
139                 </revdescription>
140             </revision>
141             <revision>
142                 <revnumber>6.0.1</revnumber>
143                 <revdescription>
144                   Simple comments are now supported in almost all possible input expressions,
145                   whatever is the shape of <literal>M</literal>.
146                 </revdescription>
147             </revision>
148         </revhistory>
149     </refsection>
150 </refentry>