sprintf, _sprintf_l, swprintf, _swprintf_l, __swprintf_l

아티클
02/21/2013

데이터 서식이 지정 된 문자열을 작성 합니다.보다 안전한 버전의 이러한 함수 중 일부를 사용할 수 있습니다. see sprintf_s, _sprintf_s_l, swprintf_s, _swprintf_s_l.보안 버전을 swprintf 및 _swprintf_l 사용 하지 않는 한 count 매개 변수.

int sprintf(
   char *buffer,
   const char *format [,
   argument] ... 
);
int _sprintf_l(
   char *buffer,
   const char *format,
   locale_t locale [,
   argument] ... 
);
int swprintf(
   wchar_t *buffer,
   size_t count,
   const wchar_t *format [,
   argument]...
);
int _swprintf_l(
   wchar_t *buffer,
   size_t count,
   const wchar_t *format,
   locale_t locale [,
   argument] ... 
);
int __swprintf_l(
   wchar_t *buffer,
   const wchar_t *format,
   locale_t locale [,
   argument] ... 
);
template <size_t size>
int sprintf(
   char (&buffer)[size],
   const char *format [,
   argument] ... 
); // C++ only
template <size_t size>
int _sprintf_l(
   char (&buffer)[size],
   const char *format,
   locale_t locale [,
   argument] ... 
); // C++ only
template <size_t size>
int swprintf(
   wchar_t (&buffer)[size],
   size_t count,
   const wchar_t *format [,
   argument]...
); // C++ only
template <size_t size>
int _swprintf_l(
   wchar_t (&buffer)[size],
   size_t count,
   const wchar_t *format,
   locale_t locale [,
   argument] ... 
); // C++ only

매개 변수

buffer
출력에 대 한 저장소 위치
count
최대 문자 수를이 함수의 유니코드 버전을 저장할 수 있습니다.
format
컨트롤 서식 문자열
argument
선택적 인수
locale
사용 하는 로캘.

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

반환 값

수 자 기록, 또는 오류가 발생 한 경우-1입니다.경우 buffer 또는 format 는 null 포인터의 설명에 따라 잘못 된 매개 변수 처리기가 호출 매개 변수 유효성 검사.이 함수 실행을 계속 수 있으면-1을 반환 합니다. 설정 하 고 errno 에 EINVAL.

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

설명

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

보안 정보
사용 하 여 sprintf, 쓴, 문자 코드를 사용 하는 방법 제한 하는 방법은 없습니다 sprintf 버퍼 오버런에 취약 합니다.관련된 함수를 사용 하는 것이 좋습니다 _snprintf, 최대 작성 해야 하는 문자를 지정 하는 buffer, 또는 사용 하 여 _scprintf 얼마나 큰 버퍼가 필요한 지 확인 합니다.또한, 확인 format 사용자 정의 문자열이 아닙니다.

사용 하 여 sprintf, 쓴, 문자 코드를 사용 하는 방법 제한 하는 방법은 없습니다 sprintf 버퍼 오버런에 취약 합니다.관련된 함수를 사용 하는 것이 좋습니다 _snprintf, 최대 작성 해야 하는 문자를 지정 하는 buffer, 또는 사용 하 여 _scprintf 얼마나 큰 버퍼가 필요한 지 확인 합니다.또한, 확인 format 사용자 정의 문자열이 아닙니다.

swprintf와이드 문자 버전입니다 sprintf. 포인터 인수에 swprintf 와이드 문자 문자열입니다.인코딩 오류를 감지 swprintf 에 있는 다를 수 있습니다 sprintf.swprintf및 fwprintf 동일 하 게 동작 swprintf 대상 형식 대신 문자열 출력을 기록 FILE, 및 swprintf 필요의 count최대 쓸 문자 수를 지정 하는 매개 변수입니다.버전으로 이러한 함수는 _l 접미사는 현재 스레드의 로캘 대신 전달 된 로캘 매개 변수를 사용할 경우를 제외 하 고 동일 합니다.

swprintfISO C 두 번째 매개 변수를 필요로 하는 표준 준수 count, 형식 size_t.이전의 비표준 동작을 강제로 정의 _CRT_NON_CONFORMING_SWPRINTFS.새 규칙 동작을 사용 하려면 코드를 변경 해야 하므로 이후 버전에서 이전 버전의 동작을 제거할 수 있습니다.

C + +에서이 함수는 최신, 보안 상응 하는 이러한 함수를 호출 하는 템플릿 오버 로드 되어 있습니다.자세한 내용은 보안 템플릿 오버 로드를 참조하십시오.

일반 텍스트 루틴 매핑

TCHAR입니다.H 루틴	_UNICODE 및 _Mbcs가 정의 되지 않았습니다.	_Mbcs가 정의	_Unicode가 정의
_stprintf	sprintf	sprintf	swprintf
_stprintf_l	_sprintf_l	_sprintf_l	__swprintf_l

요구 사항

루틴	필수 헤더
sprintf, _sprintf_l	<stdio.h>
swprintf, _swprintf_l	<stdio.h> 또는 <wchar.h>

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

예제

// crt_sprintf.c
// compile with: /W3
// This program uses sprintf 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( buffer,     "   String:    %s\n", s ); // C4996
   j += sprintf( buffer + j, "   Character: %c\n", c ); // C4996
   j += sprintf( buffer + j, "   Integer:   %d\n", i ); // C4996
   j += sprintf( buffer + j, "   Real:      %f\n", fp );// C4996
   // Note: sprintf is deprecated; consider using sprintf_s instead

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

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

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