sprintf_s, _sprintf_s_l, swprintf_s, _swprintf_s_l

아티클
02/21/2013

데이터 서식이 지정 된 문자열을 작성 합니다.이러한 버전의 있습니다 sprintf, _sprintf_l, swprintf, _swprintf_l, __swprintf_l 와 보안 기능 향상에 설명 된 대로 CRT의 보안 기능.

int sprintf_s(
   char *buffer,
   size_t sizeOfBuffer,
   const char *format [,
   argument] ... 
);
int _sprintf_s_l(
   char *buffer,
   size_t sizeOfBuffer,
   const char *format,
   locale_t locale [,
   argument] ... 
);
int swprintf_s(
   wchar_t *buffer,
   size_t sizeOfBuffer,
   const wchar_t *format [,
   argument]...
);
int _swprintf_s_l(
   wchar_t *buffer,
   size_t sizeOfBuffer,
   const wchar_t *format,
   locale_t locale [,
   argument]…
);
template <size_t size>
int sprintf_s(
   char (&buffer)[size],
   const char *format [,
   argument] ... 
); // C++ only
template <size_t size>
int swprintf_s(
   wchar_t (&buffer)[size],
   const wchar_t *format [,
   argument]...
); // C++ only

매개 변수

buffer
출력에 대 한 저장소 위치
sizeOfBuffer
최대 문자 수를 저장할 수 있습니다.
format
컨트롤 서식 문자열
argument
선택적 인수
locale
사용 하는 로캘.

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

반환 값

수 자 기록, 또는 오류가 발생 한 경우-1입니다.If buffer or format is a null pointer, sprintf_s and swprintf_s return -1 and set errno to EINVAL.

sprintf_s저장 되는 바이트 수를 반환 합니다. buffer, 종료 null 문자를 제외 합니다.swprintf_s저장 된 와이드 문자 수를 반환 합니다. buffer, 종료 null 와이드 문자 계산에서 제외 합니다.

설명

sprintf_s 함수는 서식을 지정 하는 일련의 문자 및 값을 저장 buffer.각 argument (있는 경우)이 고 변환 출력에 해당 형식 사양에 따라 format.일반 문자로 이루어진 형식과 같은 형성 및 역할을 가진 해당 format 인수에 대 한 printf.Null 문자가 작성 된 마지막 문자 뒤에 추가 됩니다.중복 문자열 사이의 복사 발생 하는 경우 동작이 정의 되지 않습니다.

기본적인 차이점은 sprintf_s 및 sprintf 입니다 sprintf_s 형식 문자열에 유효한 형식 문자를 확인 하는 반면, sprintf 은 형식 문자열 또는 버퍼 된 NULL 포인터입니다.하나 실패를 확인 하는 경우 잘못 된 매개 변수 처리기를의 설명에 따라 호출 됩니다 매개 변수 유효성 검사.실행을 계속 하려면 함수는-1 반환 하 고 설정 수 있으면 errno 에 EINVAL.

다른 주요 차이점 sprintf_s 및 sprintf 입니다 sprintf_s 문자를 출력 버퍼의 크기를 지정 하는 길이 매개 변수를 사용 합니다.인쇄 중인 텍스트에 대 한 버퍼가 너무 작을 경우 버퍼를 빈 문자열로 설정 되어 하 고 잘못 된 매개 변수 처리기를 호출 합니다.달리 snprintf, sprintf_s 버퍼 null-(버퍼 크기가 0 인 경우를 제외 하 고) 종료 한다는 것을 보장 합니다.

swprintf_s와이드 문자 버전입니다 sprintf_s. 포인터 인수에 swprintf_s 와이드 문자 문자열입니다.인코딩 오류를 감지 swprintf_s 에 있는 다를 수 있습니다 sprintf_s.버전으로 이러한 함수는 _l 접미사는 현재 스레드의 로캘 대신 전달 된 로캘 매개 변수를 사용할 경우를 제외 하 고 동일 합니다.

C + +에서이 함수를 사용 하 여 템플릿 오버 로드에 단순화 됩니다. 오버 로드에서 버퍼 길이가 자동으로 유추할 수 있습니다 (size 인수를 지정할 필요가 없습니다) 및 해당 보안에서 이미지와 이전, 안전 하지 않은 함수가 자동으로 바꿀 수 있습니다.자세한 내용은 보안 템플릿 오버 로드를 참조하십시오.

버전은 sprintf_s 버퍼가 너무 작을 경우 어떻게 추가 제어를 제공 합니다.자세한 내용은 _snprintf_s, _snprintf_s_l, _snwprintf_s, _snwprintf_s_l를 참조하십시오.

일반 텍스트 루틴 매핑

TCHAR입니다.H 루틴	_UNICODE 및 _Mbcs가 정의 되지 않았습니다.	_Mbcs가 정의	_Unicode가 정의
_stprintf_s	sprintf_s	sprintf_s	swprintf_s
_stprintf_s_l	_sprintf_s_l	_sprintf_s_l	_swprintf_s_l

요구 사항

루틴	필수 헤더
sprintf_s, _sprintf_s_l	<stdio.h>
swprintf_s, _swprintf_s_l	<stdio.h> 또는 <wchar.h>

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

예제

// crt_sprintf_s.c
// This program uses sprintf_s to format various
// data and place them in the string named buffer.
//

#include <stdio.h>

int main( void )
{
   char  buffer[200], s[] = "computer", c = 'l';
   int   i = 35, j;
   float fp = 1.7320534f;

   // Format and print various data: 
   j  = sprintf_s( buffer, 200,     "   String:    %s\n", s );
   j += sprintf_s( buffer + j, 200 - j, "   Character: %c\n", c );
   j += sprintf_s( buffer + j, 200 - j, "   Integer:   %d\n", i );
   j += sprintf_s( buffer + j, 200 - j, "   Real:      %f\n", fp );

   printf_s( "Output:\n%s\ncharacter count = %d\n", buffer, j );
}

// crt_swprintf_s.c
// wide character example
// also demonstrates swprintf_s returning error code
#include <stdio.h>

int main( void )
{
   wchar_t buf[100];
   int len = swprintf_s( buf, 100, L"%s", L"Hello world" );
   printf( "wrote %d characters\n", len );
   len = swprintf_s( buf, 100, L"%s", L"Hello\xffff world" );
   // swprintf_s fails because string contains WEOF (\xffff)
   printf( "wrote %d characters\n", len );
}