_gcvt

아티클
02/21/2013

버퍼에 저장 하는 문자열을 부동 소수점 값을 변환 합니다.보다 안전한 버전의이 함수를 사용할 수 있습니다. 참조 하십시오 _gcvt_s.

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

매개 변수

value
변환될 값입니다.
digits
유효 자릿수로 저장 합니다.
buffer
결과 대 한 저장소 위치입니다.

반환 값

_gcvt숫자 문자열에 포인터를 반환 합니다.

설명

_gcvt 함수는 부동 소수점 변환 value 를 가능한 기호 바이트 포함 하는 문자열을 문자열에 저장 하 고 buffer.buffer 변환 된 값을 더한 자동으로 추가 되는 종료 null 문자를 수용할 수 있도록 충분히 커야 합니다.버퍼 크기를 경우 digits + 1을 사용 하 고 함수는 버퍼의 끝을 덮어씁니다.변환 된 문자열에 소수점을 포함 한 기호 및 지 수 정보를 포함할 수 있습니다 때문입니다.넘침 영역에 대 한 규정이 있습니다._gcvt만들기 위해 시도 digits 숫자를 10 진수 형식입니다.불가능 한 경우이 생성 digits 숫자를 지 수 형식.뒤에 오는 0 변환에 표시 하지 않을 수 있습니다.

A buffer 의 길이가 _CVTBUFSIZE 부동에 대 한 충분 한 소수점 값입니다.

이 함수의 매개 변수의 유효성을 검사 합니다.경우 buffer 입니다 NULL, 설명에 따라 잘못 된 매개 변수 처리기가 호출 매개 변수 유효성 검사.실행을 계속 수 있으면이 함수는 설정 errno 에 EINVAL 를 반환 하 고 NULL.

요구 사항

루틴	필수 헤더
_gcvt	<stdlib.h>

더 많은 호환성 정보를 참조 하십시오. 호환성 소개에서 합니다.

예제

// 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) );
}