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').
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)