ECVT(3)

NOME
ecvt, fcvt - converte um número ponto-flutuante para uma seqüencia

SINÓPSE
#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 seqüencia terminada em nulo com ndigits digitos (onde ndigits é reduzido para o limite específico do sistema determinado pela precisão do duplo), e retorna um ponteiro para a seqüencia. O digito de mais alta ordem não é zero, a menos que number seja zero. O digito de mais baixa ordem é arredondado. A seqüencia em si não contém o ponto decimal; entretanto, a posição do ponto decimal relativo ao início da seqüencia é armazenada em *decpt. Um valor negativo para *decpt significa que o ponto decimal está a esquerda do início da seqüencia. 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.

VALORES RETORNADOS
Ambas as funções ecvt() e fcvt() retornam um ponteiro para uma seqüencia estática contendo a representação ASCII de number. A seqüencia 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').

DE ACORDO COM
SysVR2, XPG2.

VEJA TAMBÉM
gcvt(3), setlocale(3), sprintf(3).

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

  Tradução:
Marcelo D. Beckmann <marcelobeckmann@yahoo.com>

  Revisão.:
André Luiz Fassone <lonely_wolf@ig.com.br>