Scroll to navigation

ECVT(3) Manual do Programador do Linux ECVT(3)

NOME

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

SINOPSE

#include <stdlib.h>

char *ecvt(double number, int ndigits, int *decpt, int *sign);

char *fcvt(double number, int ndigits, int *decpt, int *sign);

Requisitos de macro de teste de recursos para o glibc (consulte feature_test_macros(7)):

ecvt(), fcvt():

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


    || /* Desde o Glibc 2.19: */ _DEFAULT_SOURCE


    || /* Glibc versões <= 2.19: */ _SVID_SOURCE
_SVID_SOURCE || _XOPEN_SOURCE >= 500

DESCRIÇÃO

The ecvt() function converts number to a null-terminated string of ndigits digits (where ndigits is reduced to a system-specific limit determined by the precision of a double), and returns a pointer to the string. The high-order digit is nonzero, unless number is zero. The low order digit is rounded. The string itself does not contain a decimal point; however, the position of the decimal point relative to the start of the string is stored in *decpt. A negative value for *decpt means that the decimal point is to the left of the start of the string. If the sign of number is negative, *sign is set to a nonzero value, otherwise it is set to 0. If number is zero, it is unspecified whether *decpt is 0 or 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 seqüencia estática contendo a representação ASCII de number. A seqüencia estática é sobrescrita a cada chamada a ecvt() ou fcvt().

ATRIBUTOS

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

Interface Atributo Valor
ecvt() Thread safety MT-Unsafe race:ecvt
fcvt() Thread safety MT-Unsafe race:fcvt

DE ACORDO COM

SVr2; marked as LEGACY in POSIX.1-2001. POSIX.1-2008 removes the specifications of ecvt() and fcvt(), recommending the use of sprintf(3) instead (though snprintf(3) may be preferable).

NOTAS

Not all locales use a point as the radix character ("decimal point").

VEJA TAMBÉM

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

COLOFÃO

Esta página faz parte da versão 5.10 do projeto Linux man-pages. Uma descrição do projeto, informações sobre relatórios de bugs e a versão mais recente desta página podem ser encontradas em https://www.kernel.org/doc/man-pages/.

TRADUÇÃO

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

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.

15 março 2016