_fcvt

부동 소수점 숫자를 문자열로 변환합니다. 이 함수의 더 안전한 버전을 사용할 수 있습니다. 를 참조하세요 _fcvt_s.

구문

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

매개 변수

value
변환할 숫자입니다.

count
소수점 뒤의 자릿수입니다.

dec
저장된 소수점 위치의 포인터입니다.

sign
저장된 부호 표시기의 포인터입니다.

반환 값

_fcvt 는 오류 발생시 숫자 문자열에 대한 포인터를 반환합니다 NULL .

설명

_fcvt 함수는 부동 소수점 숫자를 null 종료 문자열로 변환합니다. value 매개 변수는 변환할 부동 소수점 숫자입니다. _fcvt는 value 중 숫자를 문자열로 저장하고 null 문자('\0')를 추가합니다. count 매개 변수는 소수점 뒤에 저장할 자릿수를 지정합니다. 나머지 숫자는 count자리로 반올림됩니다. 정밀도의 숫자가 count개보다 적으면 문자열이 0으로 채워집니다.

반환 _fcvt 된 총 자릿수는 초과 _CVTBUFSIZE되지 않습니다.

숫자만 문자열에 저장됩니다. 소수점 위치와 value의 부호는 호출 후에 dec 및 sign에서 얻을 수 있습니다. dec 매개 변수는 문자열의 시작을 기준으로 소수점의 위치를 제공하는 정수 값을 가리킵니다. 0 또는 음의 정수 값은 소수점이 첫 번째 숫자의 왼쪽에 있다는 것을 나타냅니다. 매개 변수 sign은 value의 부호를 나타내는 정수를 가리킵니다. value가 양수일 경우 정수가 0으로 설정되고 value가 음수일 경우 0이 아닌 숫자로 설정됩니다.

_ecvt와 _fcvt의 차이는 count 매개 변수의 해석에 있습니다. _ecvt는 count를 출력 문자열의 전체 숫자 개수로 해석하는 반면, _fcvt는 count를 소수점 뒤의 자릿수로 해석합니다.

_ecvt 및 _fcvt는 정적으로 할당된 단일 버퍼를 변환에 사용합니다. 이러한 루틴 중 하나를 호출할 때마다 이전 호출의 결과가 삭제됩니다.

이 함수는 해당 매개 변수의 유효성을 검사합니다. 매개 변수 유효성 검사에 설명된 대로 잘못된 매개 변수 처리기가 호출되거나 0이면 dec 호출됩니다.signNULLcount 실행을 계속 errno 하도록 허용되면 로 EINVAL설정되고 NULL 반환됩니다.

기본적으로 이 함수의 전역 상태는 애플리케이션으로 범위가 지정됩니다. 이 동작을 변경하려면 CRT의 전역 상태를 참조하세요.

요구 사항

함수	필수 헤더
_fcvt	<stdlib.h>

호환성에 대한 자세한 내용은 호환성을 참조하세요.

예시

// 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

참고 항목

데이터 변환
수학 및 부동 소수점 지원
atof, _atof_l, _wtof, _wtof_l
_ecvt
_gcvt