NOME

       ecvt, fcvt - converte um número ponto-flutuante para uma cadeia de caracteres.

SINOPSE

       #include <stdlib.h>

       char *ecvt(double number, int ndigits, int *decpt, int *sign);

       char *fcvt(double number, int ndigits, int *decpt, int *sign);

DESCRIÇÃO

       A  função  ecvt()  converte  number  para  uma  cadeia de caracteres terminada em nulo com
       ndigits digitos (onde ndigits é reduzido para o limite específico do  sistema  determinado
       pela  precisão  do double), e retorna um ponteiro para a cadeia de caracteres. O digito de
       mais alta ordem é não zero, a menos que number seja zero. O digito de mais baixa  ordem  é
       arredondado.   A  cadeia  de  caracteres  em  si não contém o ponto decimal; entretanto, a
       posição do ponto decimal relativo ao início  da  cadeia  de  caracteres  é  armazenada  em
       *decpt.  Um  valor  negativo  para *decpt significa que o ponto decimal está a esquerda do
       início da cadeia de caracteres. Se o sinal de number é negativo, *sign recebe um valor não
       zero, caso contrário recebe 0. Se number é zero, não especifica se *decpt é 0 ou 1.

       A  função  fcvt()  é  identica a ecvt(), exceto que ndigits especifica o número de digitos
       após o ponto decimal.

VALOR DE RETORNO

       Ambas as funções ecvt() e fcvt() retornam  um  ponteiro  para  uma  cadeia  de  caracteres
       estática  contendo  a  representação  ASCII  de number.  A cadeia de caracteres estática é
       sobrescrita a cada chamada a ecvt() ou fcvt().

NOTAS

       Essas funções são obsoletas. Em seu lugar, sprintf() é recomendada.  As bibliotecas  Linux
       libc4  e  libc5 especificam o tipo de ndigits como size_t.  Nem todas as localidade usam o
       ponto como caracter separador (`ponto decimal').

CONFORMIDADE

       SysVR2, XPG2

VEJA TAMBÉM

       gcvt(3), setlocale(3), sprintf(3)

TRADUZIDO POR LDP-BR em 21/08/2000.

       Marcelo  D.  Beckmann  <marcelobeckmann@yahoo.com>  (tradução)  Espaço  para   o   Revisor
       <nome@dominio.com.br> (revisão)

                                          25 Junho 1999                                   ECVT(3)