_scprintf, _scprintf_l, _scwprintf, _scwprintf_l

아티클
02/21/2013

서식이 지정 된 문자열의 문자 수를 반환합니다.

int _scprintf(
   const char *format [,
   argument] ... 
);
int _scprintf_l(
   const char *format,
   locale_t locale [,
   argument] ... 
);
int _scwprintf(
   const wchar_t *format [,
   argument] ... 
);
int _scwprintf_l(
   const wchar_t *format,
   locale_t locale [,
   argument] ... 
);

매개 변수

format
컨트롤 서식 문자열입니다.
argument
선택적 인수입니다.
locale
사용 하는 로캘.

자세한 내용은 형식 사양을.

반환 값

문자열을 인쇄 하거나 파일 또는 지정한 서식 지정 코드를 사용 하 여 버퍼를 전송 하는 경우에 생성 되는 문자 수를 반환 합니다.반환 된 값을 null 종결 문자를 포함 하지 않습니다._scwprintf와이드 문자에 대 한 동일한 기능을 수행합니다.

경우 format 되는 NULL 포인터를 잘못 된 매개 변수 처리기 호출에서에 설명 된 대로 매개 변수 유효성 검사.이 함수 실행을 계속 수 있으면-1을 반환 합니다. 설정 하 고 errno 에 EINVAL.

이러한 문제 및 기타 오류 코드에 대 한에 대 한 자세한 내용은 _doserrno, errno, _sys_errlist, 및 _sys_nerr.

설명

각 argument (있는 경우)에 해당 형식 사양에 따라 변환 됩니다 format.일반 문자로 이루어진 형식과 같은 형성 및 역할을 가진 해당 format 인수에 대 한 printf.

버전으로 이러한 함수는 _l 접미사는 현재 스레드의 로캘 대신 전달 된 로캘 매개 변수를 사용할 경우를 제외 하 고 동일 합니다.

보안 정보
확인 format 사용자 정의 문자열이 아닙니다.

일반 텍스트 루틴 매핑

Tchar.h 루틴	_UNICODE 및 _mbcs가 정의 되지 않았습니다.	_Mbcs가 정의	_Unicode가 정의
_sctprintf	_scprintf	_scprintf	_scwprintf
_sctprintf_l	_scprintf_l	_scprintf_l	_scwprintf_l

요구 사항

루틴	필수 헤더
_scprintf, _scprintf_l	<stdio.h>
_scwprintf, _scwprintf_l	<stdio.h> 또는 <wchar.h>

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

예제

// crt__scprintf.c

#define _USE_MATH_DEFINES

#include <stdio.h>
#include <math.h>
#include <malloc.h>

int main( void )
{
   int count;
   int size;
   char *s = NULL;

   count = _scprintf( "The value of Pi is calculated to be %f.\n",
                      M_PI);

   size = count + 1; // the string will need one more char for the null terminator
   s = malloc(sizeof(char) * size);
   sprintf_s(s, size, "The value of Pi is calculated to be %f.\n",
                      M_PI);
   printf("The length of the following string will be %i.\n", count);
   printf("%s", s);
   free( s );
}