Revert "* Bugs #9838,9839,10196 fixed: evstr(strarray) 2.3 x faster + more robust...
[scilab.git] / scilab / modules / string / help / pt_BR / evstr.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"
3     xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns4="http://www.w3.org/1999/xhtml"
4     xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook"
5     xmlns:scilab="http://www.scilab.org" xml:id="evstr" xml:lang="pt">
6     <refnamediv>
7         <refname>evstr</refname>
8         <refpurpose>avaliação de expressões</refpurpose>
9     </refnamediv>
10     <refsynopsisdiv>
11         <title>Seqüência de Chamamento</title>
12         <synopsis>
13             H = evstr(Z)
14             [H,ierr] = evstr(Z)
15         </synopsis>
16     </refsynopsisdiv>
17     <refsection>
18         <title>Parâmetros</title>
19         <variablelist>
20             <varlistentry>
21                 <term>Z</term>
22                 <listitem>
23                     <para>
24                         matriz de strings <literal>M</literal> ou
25                         <literal>list(M,Subexp)</literal>
26                     </para>
27                     <variablelist>
28                         <varlistentry>
29                             <term>M</term>
30                             <listitem>
31                                 <para>matriz de strings</para>
32                             </listitem>
33                         </varlistentry>
34                         <varlistentry>
35                             <term>Subexp</term>
36                             <listitem>
37                                 <para>vetor de strings</para>
38                             </listitem>
39                         </varlistentry>
40                     </variablelist>
41                 </listitem>
42             </varlistentry>
43             <varlistentry>
44                 <term>H</term>
45                 <listitem>
46                     <para>matriz</para>
47                 </listitem>
48             </varlistentry>
49             <varlistentry>
50                 <term>ierr</term>
51                 <listitem>
52                     <para>inteiro, indicador de erro</para>
53                 </listitem>
54             </varlistentry>
55         </variablelist>
56     </refsection>
57     <refsection>
58         <title>Descrição</title>
59         <para>
60             Retorna o resultado da avaliação da matriz de strings <literal>M</literal>.
61             Cada elemento da matriz deve definir uma expressão Scilab válida.
62         </para>
63         <para>
64             Se a avaliação de <literal>M</literal> levar a um erro, a versão de
65             valor de único retorno, <literal>H=evstr(M)</literal>, levanta erro de
66             modo usual. A versão de dois valores de retorno,
67             <literal>[H,ierr]=evstr(M)</literal> , por outro lado, não produz erro,
68             mas retorna o número de erro em <literal>ierr</literal>.
69         </para>
70         <para>
71             Se <literal>Z</literal> é uma lista, <literal>Subexp </literal> é um
72             vetor de strings, que define subexpressões que são avaliadas antes da
73             avaliação de <literal>M</literal>. Estas subexpressões devem ser referidas
74             como <literal>%(k)</literal> em <literal>M</literal>, onde
75             <literal>k</literal> é o índice da subexpressão em
76             <literal>Subexp</literal>.
77         </para>
78         <warning>
79             <varname>Z</varname> should not include any continuation marks (..).
80         </warning>
81     </refsection>
82     <refsection>
83         <title>Exemplos</title>
84         <programlisting role="example"><![CDATA[
85 a = 1; b = 2; Z = ['a','b'] ;
86 evstr(Z)
87
88 a = 1; b = 2; Z = list(['%(1)','%(1)-%(2)'],['a+1','b+1']);
89 evstr(Z)
90
91 evstr('NaN'), evstr('Inf')
92 ]]>     </programlisting>
93     </refsection>
94     <refsection>
95         <title>Ver Também</title>
96         <simplelist type="inline">
97             <member>
98                 <link linkend="execstr">execstr</link>
99             </member>
100         </simplelist>
101     </refsection>
102 </refentry>