ECVT(3)

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)