* Bug 14741 fixed: [m,e]=log2(x) documented. frexp()=>internal
[scilab.git] / scilab / modules / elementary_functions / help / pt_BR / floating_point / frexp.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) 2008 - INRIA
5  *
6  * Copyright (C) 2012 - 2016 - Scilab Enterprises
7  *
8  * This file is hereby licensed under the terms of the GNU GPL v2.0,
9  * pursuant to article 5.3.4 of the CeCILL v.2.1.
10  * This file was originally licensed under the terms of the CeCILL v2.1,
11  * and continues to be available under such terms.
12  * For more information, see the COPYING file which you should have received
13  * along with this program.
14  *
15  -->
16 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
17           xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns5="http://www.w3.org/1999/xhtml"
18           xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook"
19           xmlns:scilab="http://www.scilab.org" xml:id="frexp" xml:lang="pt">
20     <refnamediv>
21         <refname>frexp</refname>
22         <refpurpose>separa um número em ponto flutuante em potência de base 2 e mantissa
23             <emphasis role="bold">(deprecated)</emphasis>
24         </refpurpose>
25     </refnamediv>
26     <refsynopsisdiv>
27         <title>Seqüência de Chamamento</title>
28         <synopsis>[f, e] = frexp(x)</synopsis>
29     </refsynopsisdiv>
30     <refsection>
31         <title>Parâmetros</title>
32         <variablelist>
33             <varlistentry>
34                 <term>x</term>
35                 <listitem>
36                     <para>vetor ou matriz de reais </para>
37                 </listitem>
38             </varlistentry>
39             <varlistentry>
40                 <term>f</term>
41                 <listitem>
42                     <para>array de valores reais, geralmente no intervalo 0.5 &lt;=
43                         abs(f) &lt; 1.
44                     </para>
45                 </listitem>
46             </varlistentry>
47             <varlistentry>
48                 <term>e</term>
49                 <listitem>
50                     <para>
51                         array de inteiros que satisfazem a equação: <literal>x=
52                             f.*2.^e
53                         </literal>
54                     </para>
55                 </listitem>
56             </varlistentry>
57         </variablelist>
58     </refsection>
59     <refsection>
60         <title>Descrição</title>
61         <warning>
62             <literal>frexp()</literal> becomes an internal function in Scilab 6.1.x.
63             Please use <literal>[f,e] = log2(x)</literal> instead.
64         </warning>
65         <para>Esta função corresponde à função ANSI C frexp(). Quaisquer zeros em
66             <literal>x</literal> produzem <literal>f=0</literal> e
67             <literal>e=0</literal>.
68         </para>
69     </refsection>
70     <refsection>
71         <title>Exemplos</title>
72         <programlisting role="example"><![CDATA[
73 [f,e]=frexp([1,%pi,-3,%eps])
74  ]]></programlisting>
75     </refsection>
76     <refsection role="see also">
77         <title>Ver Também</title>
78         <simplelist type="inline">
79             <member>
80                 <link linkend="log">log</link>
81             </member>
82             <member>
83                 <link linkend="hat">hat</link>
84             </member>
85             <member>
86                 <link linkend="ieee">ieee</link>
87             </member>
88             <member>
89                 <link linkend="log2">log2</link>
90             </member>
91         </simplelist>
92     </refsection>
93     <refsection role="history">
94         <title>Histórico</title>
95         <revhistory>
96             <revision>
97                 <revnumber>6.1.0</revnumber>
98                 <revdescription>
99                     frexp() becomes internal. It is publicly replaced with [f,e]=log2(x).
100                 </revdescription>
101             </revision>
102         </revhistory>
103     </refsection>
104 </refentry>