* Bug 16148: xmlSetValues() <= setPreferencesValue()
[scilab.git] / scilab / modules / elementary_functions / help / pt_BR / 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:ns5="http://www.w3.org/1999/xhtml"
19     xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook"
20     xmlns:scilab="http://www.scilab.org" xml:id="ieee" xml:lang="pt">
21     <refnamediv>
22         <refname>ieee</refname>
23         <refpurpose>ajusta o modo de exceção de ponto flutuante</refpurpose>
24     </refnamediv>
25     <refsynopsisdiv>
26         <title>Seqüência de Chamamento</title>
27         <synopsis>mod=ieee()
28             ieee(mod)
29         </synopsis>
30     </refsynopsisdiv>
31     <refsection>
32         <title>Parâmetros</title>
33         <variablelist>
34             <varlistentry>
35                 <term>mod</term>
36                 <listitem>
37                     <para>escalar inteiro com possíveis valores 0,1,ou 2</para>
38                 </listitem>
39             </varlistentry>
40         </variablelist>
41     </refsection>
42     <refsection>
43         <title>Descrição</title>
44         <para>
45             <literal>ieee()</literal> retorna o modo de exceção de ponto
46             flutuante corrente
47         <variablelist>
48             <varlistentry>
49                 <term>0</term>
50                 <listitem>
51                     <para>exceção de ponto flutuante produz um erro;</para>
52                     <para>
53                        <literal>%inf</literal> and <literal>%nan</literal> special values can be
54                        used in this mode without error. For instance, <literal>%inf/%inf</literal>,
55                        <literal>%inf-%inf</literal> or <literal>%inf/%nan</literal> are known
56                        operations.
57                     </para>
58                 </listitem>
59             </varlistentry>
60             <varlistentry>
61                 <term>1</term>
62                 <listitem>
63                     >exceção de ponto flutuante produz um aviso.
64                 </listitem>
65             </varlistentry>
66             <varlistentry>
67                 <term>2</term>
68                 <listitem>
69                     exceção de ponto flutuante produz um Inf ou NaN ("infinito" ou
70                         "não é número").
71                 </listitem>
72             </varlistentry>
73         </variablelist>
74         </para>
75         <para>
76             <literal>ieee(mod)</literal> sets the current floating point exception mode to
77             <varname>mod</varname>.
78         </para>
79         <note>
80             The default initial mode is 2. This default value may be set in any of the following ways:
81             <itemizedlist>
82                 <listitem>
83                   Through the Preferences GUI: <code>preferences</code>, in the section
84                   <emphasis role="italic">General => Environment => ieee</emphasis>.
85                 </listitem>
86                 <listitem>
87                   Equivalently, using <code>xmlSetValues</code> as follows (to set the mode to 1) :
88                   <para>
89                   <literal>xmlSetValues("//general/body/environment", ["fpe";"1"])</literal>
90                   </para>
91                 </listitem>
92                 <listitem>
93                     Or by using <literal>ieee(mod)</literal> in your startup file.
94                 </listitem>
95             </itemizedlist>
96         </note>
97         <warning>
98             Exceções de ponto flutuante emergentes em alguns algoritmos de  bibliotecas ainda não
99             são manipuladas pelos modos <literal>ieee</literal>.
100         </warning>
101     </refsection>
102     <refsection>
103         <title>Exemplos</title>
104         <programlisting role="example"><![CDATA[
105 ieee(1);1/0
106 ieee(2);1/0,log(0)
107  ]]></programlisting>
108     </refsection>
109     <refsection role="see also">
110         <title>Ver também</title>
111         <simplelist type="inline">
112             <member>
113                 <link linkend="percentnan">%nan</link>
114             </member>
115             <member>
116                 <link linkend="percentinf">%inf</link>
117             </member>
118             <member>
119                 <link linkend="isinf">isinf</link>
120             </member>
121             <member>
122                 <link linkend="isnan">isnan</link>
123             </member>
124             <member>
125                 <link linkend="number_properties">number_properties</link>
126             </member>
127         </simplelist>
128     </refsection>
129     <refsection role="history">
130         <title>Histórico</title>
131         <revhistory>
132             <revision>
133                 <revnumber>6.0.0</revnumber>
134                 <revremark>O valor de modo incial é 2.</revremark>
135             </revision>
136         </revhistory>
137     </refsection>
138 </refentry>