_gcvt

Converte um valor de ponto flutuante para string, ele armazena em um buffer.Uma versão mais segura desta função está disponível. consulte _gcvt_s.

char *_gcvt( 
   double value,
   int digits,
   char *buffer 
);

Parâmetros

value
Valor a ser convertido.
digits
Número de dígitos significativos que armazenados.
buffer
Local de armazenamento para o resultado.

Valor de retorno

_gcvtRetorna um ponteiro para a seqüência de dígitos.

Comentários

O _gcvt função converte um ponto flutuante value a uma seqüência de caracteres (que inclui uma vírgula decimal e um byte de sinal possíveis) e armazena a cadeia de caracteres buffer.O buffer deve ser grande o suficiente para acomodar o valor convertido além de um caractere nulo de terminação, que é acrescentado automaticamente.Se um tamanho de buffer de digits + 1 é usado, a função sobrescreve o final do buffer.Isso ocorre porque a seqüência convertida inclui um ponto decimal e pode conter sinal e expoente.Não há nenhuma provisão para estouro._gcvtas tentativas de produzir digits dígitos no formato decimal.Se não for possível, ele produz digits dígitos no formato exponencial.Zeros à direita podem ser suprimidos na conversão.

A buffer comprimento _CVTBUFSIZE é suficiente para flutuantes qualquer valor de ponto.

Esta função valida seus parâmetros.Se buffer é NULL, 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, essa função define errno para EINVAL e retorna NULL.

Requisitos

Rotina	Cabeçalho necessário
_gcvt	<stdlib.h>

Para obter mais informações de compatibilidade, consulte compatibilidade na introdução.

Exemplo

// crt_gcvt.c
// compile with: /W3
#include <stdlib.h>
#include <stdio.h>
#include <string.h>

int main( void )
{
   char buffer[_CVTBUFSIZE];
   double value = -1234567890.123;
   printf( "The following numbers were converted by _gcvt(value,12,buffer):\n" );
   _gcvt( value, 12, buffer ); // C4996
   // Note: _gcvt is deprecated; consider using _gcvt_s instead
   printf( "buffer: '%s' (%d chars)\n", buffer, strlen(buffer) );
   value *= 10;
   _gcvt( value, 12, buffer ); // C4996
   printf( "buffer: '%s' (%d chars)\n", buffer, strlen(buffer) );
   value *= 10;
   _gcvt( value, 12, buffer ); // C4996
   printf( "buffer: '%s' (%d chars)\n", buffer, strlen(buffer) );
   value *= 10;
   _gcvt( value, 12, buffer ); // C4996
   printf( "buffer: '%s' (%d chars)\n", buffer, strlen(buffer) );

   printf( "\n" );
   value = -12.34567890123;
   _gcvt( value, 12, buffer ); // C4996
   printf( "buffer: '%s' (%d chars)\n", buffer, strlen(buffer) );
   value /= 10;
   _gcvt( value, 12, buffer ); // C4996
   printf( "buffer: '%s' (%d chars)\n", buffer, strlen(buffer) );
   value /= 10;
   _gcvt( value, 12, buffer ); // C4996
   printf( "buffer: '%s' (%d chars)\n", buffer, strlen(buffer) );
   value /= 10;
   _gcvt( value, 12, buffer ); // C4996
   printf( "buffer: '%s' (%d chars)\n", buffer, strlen(buffer) );
}