Improve the display of the example
[scilab.git] / scilab / modules / string / help / fr_FR / 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" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns5="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="evstr" xml:lang="fr">
3     <refnamediv>
4         <refname>evstr</refname>
5         <refpurpose>évaluation d'une expression</refpurpose>
6     </refnamediv>
7     <refsynopsisdiv>
8         <title>Séquence d'appel</title>
9         <synopsis>H=evstr(Z)
10             [H,ierr]=evstr(Z)
11         </synopsis>
12     </refsynopsisdiv>
13     <refsection>
14         <title>Paramètres</title>
15         <variablelist>
16             <varlistentry>
17                 <term>Z</term>
18                 <listitem>
19                     <para>
20                         matrice de chaînes de caractères <literal>M</literal> ou
21                         <literal>list(M,Subexp)</literal>
22                     </para>
23                     <variablelist>
24                         <varlistentry>
25                             <term>M</term>
26                             <listitem>
27                                 <para>matrice de chaînes de caractères</para>
28                             </listitem>
29                         </varlistentry>
30                         <varlistentry>
31                             <term>Subexp</term>
32                             <listitem>
33                                 <para>vecteur de chaînes de caractères</para>
34                             </listitem>
35                         </varlistentry>
36                     </variablelist>
37                 </listitem>
38             </varlistentry>
39             <varlistentry>
40                 <term>H</term>
41                 <listitem>
42                     <para>matrice</para>
43                 </listitem>
44             </varlistentry>
45             <varlistentry>
46                 <term>ierr</term>
47                 <listitem>
48                     <para>entier, 0 ou numéro de l'erreur</para>
49                 </listitem>
50             </varlistentry>
51         </variablelist>
52     </refsection>
53     <refsection>
54         <title>Description</title>
55         <para>Renvoie le résultat de l'évaluation de la matrice de chaînes de
56             caractères <literal>M</literal>. Chaque élément de la matrice doit être
57             une expression Scilab valide.
58         </para>
59         <para>
60             Si l'évaluation d'un terme de <literal>M</literal> conduit à une
61             erreur, la syntaxe habituelle <literal>H=evstr(M)</literal>, déclenche le
62             message d'erreur. Dans la syntaxe <literal>[H,ierr]=evstr(M)</literal>
63             aucun message d'erreur n'est produit, mais le numéro de l'erreur est
64             renvoyé dans <literal>ierr</literal>.
65         </para>
66         <para>
67             Si <literal>Z</literal> est une liste, <literal>Subexp</literal> est
68             un vecteur de chaînes de caractères qui définit des sous-expressions qui
69             sont évaluées avant <literal>M</literal>. Ces sous-expressions doivent
70             être référencées par l'expression <literal>%(k)</literal> dans
71             <literal>M</literal>, où <literal>k</literal> est la position de la
72             sous-expression dans la liste <literal>Subexp</literal>.
73         </para>
74         <para>evstr('a=1') n'est pas valide (utiliser pour cela
75             <literal>execstr</literal>).
76         </para>
77         <para>Nan et Nan seront interpretés comme %nan.</para>
78         <para>Inf sera interpreté comme %inf</para>
79     </refsection>
80     <refsection>
81         <title>Exemples</title>
82         <programlisting role="example"><![CDATA[ 
83 a = 1;
84 b = 2;
85 Z = ['a','b'];
86 evstr(Z)
87 a = 1;
88 b = 2;
89 Z = list(['%(1)','%(1)-%(2)'],['a+1','b+1']);
90 evstr(Z)
91 evstr('NaN'), evstr('Inf') 
92         ]]></programlisting>
93     </refsection>
94     <refsection role="see also">
95         <title>Voir aussi</title>
96         <simplelist type="inline">
97             <member>
98                 <link linkend="execstr">execstr</link>
99             </member>
100         </simplelist>
101     </refsection>
102 </refentry>