Improve the display of the example
[scilab.git] / scilab / modules / string / help / fr_FR / string.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2 <!--
3  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
4  * Copyright (C) INRIA - 
5  * 
6  * This file must be used under the terms of the CeCILL.
7  * This source file is licensed as described in the file COPYING, which
8  * you should have received as part of this distribution.  The terms
9  * are also available at    
10  * http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt
11  *
12  -->
13 <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="string" xml:lang="fr">
14     <refnamediv>
15         <refname>string</refname>
16         <refpurpose>conversion en chaîne de caractères</refpurpose>
17     </refnamediv>
18     <refsynopsisdiv>
19         <title>Séquence d'appel</title>
20         <synopsis>string(x)
21             [out, in, text] = string(x)
22         </synopsis>
23     </refsynopsisdiv>
24     <refsection>
25         <title>Paramètres</title>
26         <variablelist>
27             <varlistentry>
28                 <term>x</term>
29                 <listitem>
30                     <para>Booléen, complexe, réel, entier, polynôme matrice,
31                         bibliotheque ou fonction
32                     </para>
33                 </listitem>
34             </varlistentry>
35         </variablelist>
36     </refsection>
37     <refsection>
38         <title>Description</title>
39         <para>Convertit une matrice en matrice de chaînes de caractères.</para>
40         <para>
41             Si <literal>x</literal> est une fonction <literal>[out, in, text] =
42                 string(x)
43             </literal>
44             retourne 3 vecteurs de chaînes de caractères :
45             <literal>out</literal> est le vecteur des variables de sortie,
46             <literal>in</literal> est le vecteur des variables d'entrée, et
47             <literal>text</literal> est le vecteur colonne du code source de la
48             fonction.
49         </para>
50         <para>
51             Si <literal>x</literal> est une variable bibliotheque
52             <literal>lib</literal>, text est un vecteur colonne de chaînes de
53             caractères. Le premier élément contient le chemin de la bibliothèque et
54             l'autre élément le nom des fonctions qui sont définies dans cette
55             bibliothèque.
56         </para>
57         <para>Les chaînes de caractères sont définies de la façon suivant,
58             <literal>'string'</literal> (entre quotes) ou <literal>"string"</literal>
59             (entre double quotes); les matrices de chaînes de caractères sont définies
60             comme des matrices constantes normales.
61         </para>
62         <para>La concaténation des chaînes de caractères est effectuée par
63             l'opérateur <literal>+</literal>.
64         </para>
65         <para>
66             pour les types Booléen, complexe, réel, entier, polynôme matrice le texte issu de <literal>string</literal> est dependant de la fonction <link linkend="format">format</link> (voir exemples).
67         </para>
68     </refsection>
69     <refsection>
70         <title>Exemples</title>
71         <programlisting role="example"><![CDATA[ 
72 string(rand(2, 2))
73             
74 deff("y = mymacro(x)", "y = x + 1")
75 [out, in, text] = string(mymacro)
76 x = 123.356; 
77 disp("Result is " + string(x));
78
79 disp("/" + string(~%t) + "/");
80 disp("/" + string(%i+1) + "/");
81 disp("/" + string(int16(-123)) + "/");
82 disp("/" + string(1 + %s + %s^3) + "/");
83
84 string(corelib)
85
86 v = format();
87 disp(string(%pi))
88 format(24);
89 disp(string(%pi))
90 format(v(2))
91  ]]></programlisting>
92     </refsection>
93     <refsection role="see also">
94         <title>Voir aussi</title>
95         <simplelist type="inline">
96             <member>
97                 <link linkend="part">part</link>
98             </member>
99             <member>
100                 <link linkend="length">length</link>
101             </member>
102             <member>
103                 <link linkend="quote">quote</link>
104             </member>
105             <member>
106                 <link linkend="evstr">evstr</link>
107             </member>
108             <member>
109                 <link linkend="execstr">execstr</link>
110             </member>
111             <member>
112                 <link linkend="strsubst">strsubst</link>
113             </member>
114             <member>
115                 <link linkend="strcat">strcat</link>
116             </member>
117             <member>
118                 <link linkend="strindex">strindex</link>
119             </member>
120             <member>
121                 <link linkend="sci2exp">sci2exp</link>
122             </member>
123         </simplelist>
124     </refsection>
125 </refentry>