_fcvt
Converte um número de ponto flutuante como uma cadeia de caracteres. Uma versão mais segura dessa função está disponível; consulte _fcvt_s.
char *_fcvt(
double value,
int count,
int *dec,
int *sign
);
Parâmetros
value
Número a ser convertido.count
Número de dígitos após o ponto decimal.dec
Ponteiro para a posição do ponto decimal armazenada.sign
Ponteiro para o indicador armazenado de sinal.
Valor de retorno
_fcvt retorna um ponteiro para a cadeia de caracteres dos dígitos, NULL em erro.
Comentários
A função de _fcvt converte um número de ponto flutuante como uma cadeia de caracteres com terminação nula. O parâmetro de value é o número de ponto flutuante a ser convertido. _fcvt armazena os dígitos de value como uma cadeia de caracteres e anexará um caractere nulo (\ “0 "). O parâmetro de count especifica o número de dígitos a serem armazenados após o ponto decimal. Os dígitos adicionais são arredondados fora para locais de count . Se houver menos do que count de dígitos de precisão, a cadeia de caracteres é preenchida com zeros.
O número total de dígitos retornados por _fcvt não excederá _CVTBUFSIZE.
Somente os 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 o sinal depois da chamada. O parâmetro de dec a um valor inteiro; este valor inteiro da posição do ponto decimal em relação ao início da cadeia de caracteres. Um valor inteiro negativo ou zero indica que o ponto decimal se encontra à esquerda do primeiro dígito. Os pontos de sign de parâmetro para um inteiro que indica o sinal de value. O inteiro é definido como 0 se value é positivo e como um número diferente de zero se value é negativo.
A diferença entre _ecvt e _fcvt está na interpretação de parâmetro de count . _ecvt interpreta count como o número total de dígitos na cadeia de caracteres de saída, enquanto que _fcvt interpreta count como o número de dígitos após o ponto decimal.
_ecvt e _fcvt usam um único buffer estaticamente atribuído à conversão. Cada chamada para uma dessas rotinas destrói os resultados da chamada anterior.
Essa função valida seus parâmetros. Se dec ou sign são NULL, ou count é 0, o manipulador inválido do parâmetro será chamado, conforme descrito em Validação do parâmetro. Se a execução for permitida continuar, errno está definido como EINVAL e NULL será retornado.
Requisitos
Função |
Cabeçalho necessário |
|---|---|
_fcvt |
<stdlib.h> |
Para obter mais informações sobre compatibilidade, consulte Compatibilidade na Introdução.
Exemplo
// crt_fcvt.c
// compile with: /W3
// This program converts the constant
// 3.1415926535 to a string and sets the pointer
// buffer to point to that string.
#include <stdlib.h>
#include <stdio.h>
int main( void )
{
int decimal, sign;
char *buffer;
double source = 3.1415926535;
buffer = _fcvt( source, 7, &decimal, &sign ); // C4996
// Note: _fcvt is deprecated; consider using _fcvt_s instead
printf( "source: %2.10f buffer: '%s' decimal: %d sign: %d\n",
source, buffer, decimal, sign );
}