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>