_fcvt
Converte um número de ponto flutuante em uma seqüência de caracteres.Uma versão mais segura desta 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 depois do ponto decimal.dec
Ponteiro para a posição do ponto decimal armazenado.sign
Ponteiro para o indicador de sinal armazenado.
Valor de retorno
_fcvt Retorna um ponteiro para a seqüência de dígitos, nulo em erro.
Comentários
The _fcvt função converte um número de ponto flutuante em uma seqüência de caracteres terminada com caractere nulo. The value parâmetro é o número de ponto flutuante a ser convertido. _fcvt armazena sistema autônomo dígitos de value sistema autônomo uma seqüência de caracteres e o acrescenta um caractere nulo ('\0'). The count parâmetro especifica o número de dígitos a serem armazenados após a vírgula decimal. Excesso de dígitos são arredondados, count locais. Se houver menos de count dígitos de precisão, a seqüência de caracteres é preenchido com zeros.
O número total de dígitos retornado por _fcvt 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 dec e o sinal após a telefonar. The dec parâmetro aponta para um valor inteiro; esse valor de inteiro dá a posição do ponto decimal ao início da string. Zero ou valor inteiro negativo indica que o ponto decimal está à esquerda do primeiro dígito.O parâmetro sign aponta para um número inteiro indicando o sinal de value. O número inteiro é definido como 0 se value é positiva e é definido como um número diferente de zero se value é negativo.
A diferença entre _ecvt e _fcvt está na interpretação das count parâmetro. _ecvt interpreta count sistema autônomo o número total de dígitos na cadeia de saída, enquanto _fcvt interpreta count sistema autônomo o número de dígitos depois do ponto decimal.
_ecvt e _fcvt Use um único alocados estaticamente buffer para a conversão. Cada telefonar para um dessas rotinas destrói os resultados da telefonar anterior.
Esta função valida os parâmetros.If dec ou sign for nulo, ou count é 0, o manipulador de parâmetro inválido é chamado, conforme descrito em Validação de parâmetro. Se a execução for permitida para continuar, errno é conjunto para EINVAL e nulo é retornado.
Requisitos
Função |
Cabeçalho necessário |
|---|---|
_fcvt |
<stdlib.h> |
Para obter mais informações de 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 );
}
source: 3.1415926535 buffer: '31415927' decimal: 1 sign: 0