_ecvt

Converte um número double em uma cadeia de caracteres. Uma versão mais segura dessa função está disponível, confira _ecvt_s.

Sintaxe

char *_ecvt(
   double value,
   int count,
   int *dec,
   int *sign
);

Parâmetros

value
Número a ser convertido.

count
Número de dígitos armazenados.

dec
Posição do ponto decimal armazenada.

sign
Sinal do número convertido.

Valor retornado

_ecvt retorna um ponteiro para a cadeia de caracteres de dígitos; NULL se ocorreu um erro.

Comentários

A função _ecvt converte um número de ponto flutuante em uma cadeia de caracteres. O parâmetro value é o número de ponto flutuante a ser convertido. Essa função armazena até count dígitos do value como uma cadeia de caracteres e acrescenta um caractere nulo ('\0'). Se o número de dígitos em value exceder count, os dígitos de ordem inferior serão arredondados. Se houver menos de count dígitos, a cadeia de caracteres será preenchida com zeros.

O número total de dígitos retornados por _ecvt não excederá _CVTBUFSIZE.

Somente dígitos são armazenados na cadeia de caracteres. A posição do ponto decimal e o sinal de value podem ser obtidos de dec e sign após a chamada. O parâmetro dec aponta para um valor inteiro dando a posição do ponto decimal em relação ao início da cadeia de caracteres. Um valor inteiro de 0 ou negativo indica que o ponto decimal se encontra à esquerda do primeiro dígito. O parâmetro sign aponta para um número inteiro que indica o sinal do número convertido. Se o valor inteiro for 0, o número será positivo. Caso contrário, o resultado será negativo.

A diferença entre _ecvt e _fcvt está na interpretação do parâmetro count. _ecvt interpreta count como o número total de dígitos na cadeia de saída, enquanto _fcvt interpreta count como o número de dígitos após o ponto decimal.

_ecvt e _fcvt usam um único buffer alocado estaticamente para a conversão. Cada chamada a uma dessas rotinas destrói o resultado da chamada anterior.

Essa função valida seus parâmetros. Se dec or sign for NULL, ou count for 0, o manipulador de parâmetro inválido será invocado, conforme descrito em Validação de parâmetro. Se a execução tiver permissão para continuar, errno será definido como EINVAL e NULL será retornado.

Por padrão, o estado global dessa função tem como escopo o aplicativo. Para alterar esse comportamento, confira Estado global no CRT.

Requisitos

Função	Cabeçalho necessário
_ecvt	<stdlib.h>

Para obter informações sobre compatibilidade, consulte Compatibilidade.

Exemplo

// crt_ecvt.c
// compile with: /W3
// This program uses _ecvt to convert a
// floating-point number to a character string.

#include <stdlib.h>
#include <stdio.h>

int main( void )
{
   int     decimal,   sign;
   char    *buffer;
   int     precision = 10;
   double  source = 3.1415926535;

   buffer = _ecvt( source, precision, &decimal, &sign ); // C4996
   // Note: _ecvt is deprecated; consider using _ecvt_s instead
   printf( "source: %2.10f   buffer: '%s'  decimal: %d  sign: %d\n",
           source, buffer, decimal, sign );
}

source: 3.1415926535   buffer: '3141592654'  decimal: 1  sign: 0

Confira também

Conversão de dados
Suporte matemático e de ponto flutuante
atof, _atof_l, _wtof, _wtof_l
_fcvt
_gcvt