NOME¶

ecvt, fcvt - converte um número de ponto flutuante em uma string

BIBLIOTECA¶

Biblioteca C Padrão (libc, -lc)

SINOPSE¶

#include <stdlib.h>

[[deprecated]] char *ecvt(double número, int ndígitos,
                          int *restrict ptdec, int *restrict sinal);
[[deprecated]] char *fcvt(double número, int ndígitos,
                          int *restrict ptdec, int *restrict sinal);

ecvt(), fcvt():

    Since glibc 2.17


        (_XOPEN_SOURCE >= 500 && ! (_POSIX_C_SOURCE >= 200809L))


            || /* glibc >= 2.20 */ _DEFAULT_SOURCE


            || /* glibc <= 2.19 */ _SVID_SOURCE


    glibc 2.12 to glibc 2.16:


        (_XOPEN_SOURCE >= 500 && ! (_POSIX_C_SOURCE >= 200112L))


            || _SVID_SOURCE


    Before glibc 2.12:


        _SVID_SOURCE || _XOPEN_SOURCE >= 500

DESCRIÇÃO¶

A função ecvt() converte número para uma string terminada em nulo com ndígitos dígitos (onde ndígitos é reduzido para o limite específico do sistema determinado pela precisão de m double), e retorna um ponteiro para a string. O dígito de mais alta ordem não é zero, a menos que número seja zero. O digito de mais baixa ordem é arredondado. A string em si não contém o ponto decimal; entretanto, a posição do ponto decimal relativo ao início da string é armazenada em *ptdec. Um valor negativo para *ptdec significa que o ponto decimal está a esquerda do início da string. Se o sinal de número é negativo, *sinal recebe um valor não zero, caso contrário recebe 0. Se número é zero, não especifica se *ptdec é 0 ou 1.

A função fcvt() é idêntica à ecvt(), exceto que ndígitos especifica o número de dígitos após o ponto decimal.

VALOR DE RETORNO¶

Ambas as funções ecvt() e fcvt() retornam um ponteiro para uma string estática contendo a representação ASCII de number. A string estática é sobrescrita a cada chamada a ecvt() ou fcvt().

ATRIBUTOS¶

Para uma explicação dos termos usados nesta seção, consulte attributes(7).

PADRÕES¶

Nenhum.

HISTÓRICO¶

SVr2; marcado como LEGACY em POSIX.1-2001. POSIX.1-2008 remove as especificações de ecvt() e fcvt(), recomendando o uso de sprintf(3) (embora snprintf(3) possa ser preferível).

NOTAS¶

Nem todas as localidades usam um ponto como separador decimal ("ponto decimal").

VEJA TAMBÉM¶

ecvt_r(3), gcvt(3), qecvt(3), setlocale(3), sprintf(3)

TRADUÇÃO¶

A tradução para português brasileiro desta página man foi criada por Marcelo D. Beckmann <marcelobeckmann@yahoo.com>, André Luiz Fassone <lonely_wolf@ig.com.br> e Rafael Fontenelle <rafaelff@gnome.org>.

Esta tradução é uma documentação livre; leia a Licença Pública Geral GNU Versão 3 ou posterior para as condições de direitos autorais. Nenhuma responsabilidade é aceita.

Se você encontrar algum erro na tradução desta página de manual, envie um e-mail para a lista de discussão de tradutores.