Provided by: manpages-pt-dev_20040726-2_all bug

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)