Merge branch 'master' into bug-4403-remove-polyfill
[maxima.git] / doc / info / pt / Floating.texi
blob34aef6db98cf41636ee7fdd35414d1ce9d3829d8
1 @c /Floating.texi/1.19/Thu Nov  2 05:46:57 2006/-ko/
2 @c ITEMS IN THIS FILE ARE IN NEED OF EXPANSION, CLARIFICATION, AND EXAMPLES
4 @menu
5 * Definições para ponto Flutuante::  
6 @end menu
8 @node Definições para ponto Flutuante,  , Ponto Flutuante, Ponto Flutuante
9 @section Definições para ponto Flutuante
11 @c FOLLOWING FUNCTIONS IN bffac.mac ARE NOT DESCRIBED IN .texi FILES: !!!
12 @c obfac, azetb, vonschtoonk, divrlst, obzeta, bfhzeta, bfpsi0 !!!
13 @c DON'T KNOW WHICH ONES ARE INTENDED FOR GENERAL USE !!!
15 @c FOLLOWING FUNCTIONS IN bffac.mac ARE DESCRIBED IN Number.texi: !!!
16 @c burn, bzeta, bfzeta !!!
18 @c FOLLOWING FUNCTIONS IN bffac.mac ARE DESCRIBED HERE: !!!
19 @c bfpsi, bffac, cbffac !!!
21 @deffn {Função} bffac (@var{expr}, @var{n})
22 Versão para grandes números em ponto flutuante da função
23 @code{factorial} (usa o artifício gamma).  O segundo argumento informa quantos dígitos reter e retornar,
24 isso é uma boa idéia para requisitar precisão adicional.
26 @code{load ("bffac")} chama essa função.
28 @end deffn
30 @defvr {Variável de Opção} algepsilon
31 Valor por omissão: 10^8
33 @c WHAT IS algepsilon, EXACTLY ??? describe ("algsys") IS NOT VERY INFORMATIVE !!!
34 @code{algepsilon} é usada por @code{algsys}.
36 @end defvr
38 @deffn {Função} bfloat (@var{expr})
39 Converte todos os números e funções de números em @var{expr} para grandes números em 
40 ponto flutuante (bigfloat).  O número de algarismos significativos no grande número em ponto flutuante resultante é especificado através da variável global @code{fpprec}.
42 Quando @code{float2bf} for @code{false} uma mensagem de alerta é mostrada quando
43 uma número em ponto flutuante (float) é convertido em um grande número em ponto flutuante (bigfloat - uma vez que
44 isso pode resultar em perda de precisão).
46 @end deffn
48 @deffn {Função} bfloatp (@var{expr})
49 Retorna @code{true} se a avaliação da @var{expr} resultar em um grande número em ponto flutuante, de outra forma retorna @code{false}.
51 @end deffn
53 @deffn {Função} bfpsi (@var{n}, @var{z}, @var{fpprec})
54 @deffnx {Função} bfpsi0 (@var{z}, @var{fpprec})
55 @code{bfpsi} é a função @code{polygamma} de argumentos reais @var{z} e ordem de inteiro @var{n}.
56 @code{bfpsi0} é a função @code{digamma}. 
57 @code{bfpsi0 (@var{z}, @var{fpprec})} é equivalente a @code{bfpsi (0, @var{z}, @var{fpprec})}.
59 Essas funções retornam valores em grandes números em ponto flutuante.
60 @var{fpprec} é a precisão do valor de retorno dos grandes números em ponto flutuante.
62 @c psi0(1) = -%gamma IS AN INTERESTING PROPERTY BUT IN THE ABSENCE OF ANY OTHER
63 @c DISCUSSION OF THE PROPERTIES OF THIS FUNCTION, THIS STATEMENT SEEMS OUT OF PLACE.
64 @c Note @code{-bfpsi0 (1, fpprec)} provides @code{%gamma} (Euler's constant) as a bigfloat.
66 @code{load ("bffac")} chama essas funções.
68 @end deffn
70 @defvr {Variável de Opção} bftorat
71 Valor por omissão: @code{false}
73 @code{bftorat} controla a conversão de @code{bfloats} para
74 números racionais. 
75 Quando @code{bftorat} for @code{false},
76 @code{ratepsilon} será usada para
77 controlar a conversão (isso resulta em números racionais relativametne
78 pequenos).
79 Quando @code{bftorat} for @code{true},
80 o número racional gerado irá
81 representar precisamente o @code{bfloat}.
83 @end defvr
85 @defvr {Variável de Opção} bftrunc
86 Valor por omissão: @code{true}
88 @code{bftrunc} faz com que tilhas de zeros em grandes números em ponto flutuante
89 diferentes de zero sejam ocultadas.  Desse modo, se @code{bftrunc} for @code{false}, @code{bfloat (1)}
90 será mostrado como @code{1.000000000000000B0}. De outra forma, será mostrado como
91 @code{1.0B0}.
93 @end defvr
95 @deffn {Função} cbffac (@var{z}, @var{fpprec})
96 Factorial complexo de grandes números em ponto flutuante.
98 @code{load ("bffac")} chama essa função.
100 @end deffn
102 @deffn {Função} float (@var{expr})
103 Converte inteiros, números racionais e grandes números em ponto flutuante em @var{expr}
104 para números em ponto flutuante.  Da mesma forma um @code{evflag}, @code{float} faz com que
105 números racionais não-inteiros e grandes números em ponto flutuante sejam convertidos para
106 ponto flutuante.
108 @end deffn
110 @defvr {Variável de Opção} float2bf
111 Valor por omissão: @code{false}
113 Quando @code{float2bf} for @code{false}, uma mensagem de alerta é mostrada quando
114 um número em ponto flutuante é convertido em um grande número em ponto flutuante (uma vez que
115 isso pode resultar em perda de precisão).
117 @end defvr
119 @deffn {Função} floatnump (@var{expr})
120 Retorna @code{true} se @var{expr} for um número em ponto flutuante, de outra forma retorna @code{false}.
122 @end deffn
124 @defvr {Variável de Opção} fpprec
125 Valor por omissão: 16
127 @code{fpprec} é o número de algarismos significativos para aritmética sobre grandes números em ponto flutuante
128 @code{fpprec} não afecta cálculos sobre números em ponto flutuante comuns.
130 Veja também @code{bfloat} e @code{fpprintprec}.
132 @end defvr
134 @defvr {Variável de Opção} fpprintprec
135 Valor por omissão: 0
137 @code{fpprintprec} é o n;umero de dígitos a serem mostrados na tela quando no caso de nuúmeros em ponto flutuante e no caso de grandes números em ponto flutuante.
139 Para números em ponto flutuante comuns,
140 quando @code{fpprintprec} tiver um valor entre 2 e 16  (inclusive),
141 o n;umero de dígitos mostrado na tela é igual a @code{fpprintprec}.
142 De outra forma, @code{fpprintprec} é 0, ou maior que 16,
143 e o número de dígitos mostrados é 16.
145 Para grandes números em ponto flutuante,
146 quando @code{fpprintprec} tiver um valor entre 2 e @code{fpprec} (inclusive),
147 o n;umero de dígitos mostrados é giaul a @code{fpprintprec}.
148 De outra forma, @code{fpprintprec} é 0, ou maior que @code{fpprec},
149 e o n;umero de dígitos mostrados é igual a @code{fpprec}.
151 @code{fpprintprec} não pode ser 1.
153 @end defvr