_ecvt
Converte um double como uma seqüência numérica.Uma versão mais segura desta função está disponível. see _ecvt_s.
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 armazenado.sign
Sinal do número convertido.
Valor de retorno
_ecvtRetorna um ponteiro para a seqüência de caracteres de dois dígitos. NULL se ocorreu um erro.
Comentários
O _ecvt função converte um número de ponto flutuante em uma seqüência de caracteres.O value parâmetro é o número de ponto flutuante a ser convertido.Esta função armazena até count dígitos do value como uma seqüência de caracteres e o acrescenta um caractere nulo ('\0').Se o número de dígitos no value excede count, é arredondado para o dígito de ordem inferior.Se houver menos que count dígitos, a seqüência de caracteres é preenchido com zeros.
O número total de dígitos retornado por _ecvt não excederá _CVTBUFSIZE.
Somente dígitos são armazenados na seqüência de caracteres.A posição do ponto decimal e o sinal de value pode ser obtido em dec e sign após a chamada.O dec parâmetro aponta para um valor inteiro, dando a posição do ponto decimal com relação ao início da seqüência de caracteres.Um valor inteiro de 0 ou negativo indica que o ponto decimal está à esquerda do primeiro dígito.O sign parâmetro aponta para um número inteiro que indica o sinal do número convertido.Se o valor inteiro for 0, o número é positivo.Caso contrário, o número for negativo.
A diferença entre _ecvt e _fcvt está sendo a interpretação do count parâmetro._ecvtinterpreta 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.
_ecvte _fcvt usar um único buffer alocado estaticamente para a conversão.Cada chamada para uma dessas rotinas destrói o resultado da chamada anterior.
Esta função valida seus parâmetros.Se dec ou sign for NULL, ou count é 0, o manipulador de parâmetro inválido é invocado, conforme descrito em Validação de parâmetro.Se a execução terá permissão para continuar, errno for definido como EINVAL e NULL é retornado.
Requisitos
Função |
Cabeçalho necessário |
|---|---|
_ecvt |
<stdlib.h> |
Para obter mais informações de compatibilidade, consulte compatibilidade na introdução.
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 );
}