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)