Fix rubberbox coordinates
[scilab.git] / scilab / modules / functions / help / fr_FR / mode.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) 2009 - DIGITEO - Allan CORNET
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.1-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:ns4="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="mode" xml:lang="fr">
14     <refnamediv>
15         <refname>mode</refname>
16         <refpurpose>choisit le mode d'exécution des scripts et des
17             fonctions
18         </refpurpose>
19     </refnamediv>
20     <refsynopsisdiv>
21         <title>Séquence d'appel</title>
22         <synopsis>mode(k)
23             k=mode()
24         </synopsis>
25     </refsynopsisdiv>
26     <refsection>
27         <title>Description</title>
28         <para>
29             Utilisé 
30             <emphasis role="bold">
31                 <literal>uniquement</literal>
32             </emphasis>
33             dans un script ou une
34             fonction, <literal>mode(k)</literal> permet de choisir le mode d'affichage
35             utilisé pendant l'exécution, suivant la valeur de
36             <literal>k</literal> :
37         </para>
38         <variablelist>
39             <varlistentry>
40                 <term>k = 0</term>
41                 <listitem>
42                     <para>les nouvelles valeurs des variables sont affichées (voir
43                         <link linkend="semicolon">semicolon</link> ou <link linkend="comma">comma</link>).
44                     </para>
45                 </listitem>
46             </varlistentry>
47             <varlistentry>
48                 <term>k = -1</term>
49                 <listitem>
50                     <para>l'exécution est silencieuse (rien n'est affiché :
51                         mode par défaut pour les fonctions)
52                     </para>
53                 </listitem>
54             </varlistentry>
55             <varlistentry>
56                 <term>k = 2</term>
57                 <listitem>
58                     <para>valeur par défaut retourné au prompt de scilab.</para>
59                     <para>veuillez noter que ce mode ne doit pas etre utilisé au prompt mais seulement via un script ou une fonction.</para>
60                 </listitem>
61             </varlistentry>
62             <varlistentry>
63                 <term>k = 1 ou k = 3</term>
64                 <listitem>
65                     <para>les nouvelles valeurs des variables sont affichées,
66                         chaque ligne de commande est affichée et
67                         précédée de l'invite de commande (mode par
68                         défaut pour les scripts lancés par "exec")
69                     </para>
70                 </listitem>
71             </varlistentry>
72             <varlistentry>
73                 <term>k = 4 ou k = 7</term>
74                 <listitem>
75                     <para>les nouvelles valeurs des variables sont affichées,
76                         chaque ligne de commande est affichée et
77                         précédée de l'invite de commande. L'exécution
78                         est interrompue après chaque ligne et reprend après un
79                         appui sur la touche entrée/return.
80                     </para>
81                     <para>Si la touche entrée/return et précédée du
82                         caractère "p", l'éxecution est suspendue (voir <link linkend="pause">pause</link>).
83                     </para>
84                 </listitem>
85             </varlistentry>
86             <varlistentry>
87                 <term>k &gt; 7</term>
88                 <listitem>
89                     <para>mode défini par l'utilisateur. Si vous définissez
90                         votre propre mode, il est recommandé d'utiliser des valeurs
91                         &gt; 100.
92                     </para>
93                 </listitem>
94             </varlistentry>
95         </variablelist>
96         <para>L'affichage est supprimé dans les fonctions compilées
97             (voir comp). Par défaut les fonctions Scilab sont
98             exécutées en mode silencieux ("-1").
99         </para>
100         <para>Les fonctions incluses dans une bibliothèque de fonctions scilab sont executés avec le mode "-1".</para>
101     </refsection>
102     <refsection>
103         <title>Exemples</title>
104         <programlisting role="exemple"><![CDATA[ 
105 // copier - coller ces lignes dans scilab
106
107 function example_mode( level_mode )
108   mode(level_mode)
109   a = 3
110   disp(mode());
111 endfunction
112
113 mode(2)
114
115 example_mode(0)
116 example_mode(-1)
117 example_mode(2)
118 example_mode(1)
119 example_mode(3)
120 example_mode(7)
121
122 mode(2)
123  ]]></programlisting>
124     </refsection>
125     <refsection role="see also">
126         <title>Voir aussi</title>
127         <simplelist type="inline">
128             <member>
129                 <link linkend="exec">exec</link>
130             </member>
131             <member>
132                 <link linkend="execstr">execstr</link>
133             </member>
134             <member>
135                 <link linkend="semicolon">semicolon</link>
136             </member>
137             <member>
138                 <link linkend="comma">comma</link>
139             </member>
140         </simplelist>
141     </refsection>
142 </refentry>