* Bug 16148: xmlSetValues() <= setPreferencesValue()
[scilab.git] / scilab / modules / elementary_functions / help / fr_FR / floating_point / ieee.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  * Copyright (C) 2017 - Samuel GOUGEON
6  *
7  * Copyright (C) 2012 - 2016 - Scilab Enterprises
8  *
9  * This file is hereby licensed under the terms of the GNU GPL v2.0,
10  * pursuant to article 5.3.4 of the CeCILL v.2.1.
11  * This file was originally licensed under the terms of the CeCILL v2.1,
12  * and continues to be available under such terms.
13  * For more information, see the COPYING file which you should have received
14  * along with this program.
15  *
16  -->
17 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
18           xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML"
19           xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org"
20           xml:lang="fr" xml:id="ieee">
21     <refnamediv>
22         <refname>ieee</refname>
23         <refpurpose>fixe ou indique le mode d'exception IEEE pour les calculs</refpurpose>
24     </refnamediv>
25     <refsynopsisdiv>
26         <title>Séquence d'appel</title>
27         <synopsis>mod = ieee()
28             ieee(mod)
29         </synopsis>
30     </refsynopsisdiv>
31     <refsection>
32         <title>Paramètres</title>
33         <variablelist>
34             <varlistentry>
35                 <term>mod  </term>
36                 <listitem>
37                     <para>un entier valant 0,1 ou 2
38                     </para>
39                 </listitem>
40             </varlistentry>
41         </variablelist>
42     </refsection>
43     <refsection>
44         <title>Description</title>
45         <para>
46             <literal>ieee()</literal> renvoie le mode d'exception IEEE courant pour les calculs en virgule flottante.
47         <variablelist>
48             <varlistentry>
49                 <term>0</term>
50                 <listitem>
51                     <para>les exceptions produisent une erreur</para>
52                     <para>
53                        Dans ce mode, les valeurs spéciales <literal>%inf</literal> et
54                        <literal>%nan</literal> sont utilisables sans erreur. Par exemple, les
55                        opérations <literal>%inf/%inf</literal>,  <literal>%inf-%inf</literal> ou
56                        <literal>%inf/%nan</literal> seront effectuées sans produire d'erreur.
57                     </para>
58                 </listitem>
59             </varlistentry>
60             <varlistentry>
61                 <term>1</term>
62                 <listitem>
63                     les exceptions produisent un warning.
64                 </listitem>
65             </varlistentry>
66             <varlistentry>
67                 <term>2</term>
68                 <listitem>
69                     les exceptions produisent Inf ou Nan.
70                 </listitem>
71             </varlistentry>
72         </variablelist>
73         </para>
74         <para>
75             <literal>ieee(mod)</literal> fixe le mode d'exception IEEE courant pour les calculs en
76             virgule flottante.
77         </para>
78         <note>
79             Le mode initial par défaut est 2. Ce réglage peut être modifié indifféremment comme suit:
80             <itemizedlist>
81                 <listitem>
82                   Via l'interface des Préférences : <code>preferences</code>, section
83                   <emphasis role="italic">Général => Environment => ieee</emphasis>.
84                 </listitem>
85                 <listitem>
86                   En utilisant <code>xmlSetValues</code> comme suit (ici pour ieee(1)) :
87                   <para>
88                   <literal>xmlSetValues("//general/body/environment", ["fpe";"1"])</literal>
89                   </para>
90                 </listitem>
91                 <listitem>
92                     Ou en indiquant <literal>ieee(mod)</literal> dans votre fichier de démarrage
93                     personnel.
94                 </listitem>
95             </itemizedlist>
96         </note>
97         <warning>
98             Certaines exceptions IEEE générées dans certains algorithmes provenant de
99             bibliothèques ne sont pas prises en compte par les modes <literal>ieee</literal>
100             pour l'instant.
101         </warning>
102     </refsection>
103     <refsection>
104         <title>Exemples</title>
105         <programlisting role="example"><![CDATA[
106 ieee(1); 1/0
107 ieee(2); 1/0, log(0)
108  ]]></programlisting>
109     </refsection>
110     <refsection role="see also">
111         <title>Voir aussi</title>
112         <simplelist type="inline">
113             <member>
114                 <link linkend="percentnan">%nan</link>
115             </member>
116             <member>
117                 <link linkend="percentinf">%inf</link>
118             </member>
119             <member>
120                 <link linkend="isinf">isinf</link>
121             </member>
122             <member>
123                 <link linkend="isnan">isnan</link>
124             </member>
125             <member>
126                 <link linkend="number_properties">number_properties</link>
127             </member>
128         </simplelist>
129     </refsection>
130     <refsection>
131         <title>Historique</title>
132         <revhistory>
133             <revision>
134                 <revnumber>6.0.0</revnumber>
135                 <revremark>2 est maintenant la valeur par défaut au lancement de Scilab.</revremark>
136             </revision>
137         </revhistory>
138     </refsection>
139 </refentry>