Compartilhar via


_fcvt

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

Sintaxe

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

Parâmetros

value
Número a ser convertido.

count
O 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 de logon armazenado.

Valor retornado

_fcvt Retorna um ponteiro para a cadeia de caracteres de dígitos, NULL em caso de erro.

Comentários

A função _fcvt converte um número de ponto flutuante em uma cadeia de caracteres com terminação nula. O parâmetro value é o número de ponto flutuante a ser convertido. _fcvt armazena os dígitos de value como uma cadeia de caracteres e acrescenta um caractere nulo ('\0'). O parâmetro count especifica o número de dígitos a serem armazenados após o ponto decimal. Dígitos em excesso são arredondados para count casas. Se houver menos de count dígitos de precisão, a cadeia de caracteres será preenchida com zeros.

O número total de dígitos retornados por _fcvt 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 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 zero ou negativo indica que o ponto decimal se encontra à esquerda do primeiro dígito. O parâmetro sign aponta para um número inteiro indicando o sinal de value. O inteiro é definido como 0 se value for positivo e é definido como um número diferente de zero se value for 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 EINVALe 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
_fcvt <stdlib.h>

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

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

Confira também

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