_snprintf_s, _snprintf_s_l, _snwprintf_s, _snwprintf_s_l

아티클
02/21/2013

서식이 지정 된 데이터 문자열을 씁니다.이러한 버전의 있습니다 _snwprintf_l, _snwprintf, _snprintf_l, _snprintf 와 보안 기능 향상에 설명 된 대로 CRT의 보안 기능.

int _snprintf_s(
   char *buffer,
   size_t sizeOfBuffer,
   size_t count,
   const char *format [,
   argument] ... 
);
int _snprintf_s_l(
   char *buffer,
   size_t sizeOfBuffer,
   size_t count,
   const char *format,
   locale_t locale [,
   argument] ... 
);
int _snwprintf_s(
   wchar_t *buffer,
   size_t sizeOfBuffer,
   size_t count,
   const wchar_t *format [,
   argument] ... 
);
int _snwprintf_s_l(
   wchar_t *buffer,
   size_t sizeOfBuffer,
   size_t count,
   const wchar_t *format,
   locale_t locale [,
   argument] ... 
);
template <size_t size>
int _snprintf_s(
   char (&buffer)[size],
   size_t count,
   const char *format [,
   argument] ... 
); // C++ only
template <size_t size>
int _snwprintf_s(
   wchar_t (&buffer)[size],
   size_t count,
   const wchar_t *format [,
   argument] ... 
); // C++ only

매개 변수

buffer
출력에 대 한 저장소 위치입니다.
sizeOfBuffer
크기 출력에 대 한 저장소 위치입니다.Size in bytes for _snprintf_s or size in words for _snwprintf_s.
Count
최대 저장 하는 문자 또는 _TRUNCATE.
format
컨트롤 서식 문자열입니다.
argument
선택적 인수입니다.
locale
사용 하는 로캘.

반환 값

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

종료 null 및 데이터를 저장 하는 데 필요한 저장 공간을 초과 하는 경우 sizeOfBuffer, 설명에 따라 잘못 된 매개 변수 처리기가 호출 매개 변수 유효성 검사.잘못 된 매개 변수 처리기 한 후 실행을 계속 하는 경우 이러한 함수를 설정 buffer 를 빈 문자열로 설정 errno 에 ERANGE, 및-1을 반환 합니다.

경우 buffer 또는 format 되는 NULL 포인터를 경우 count 가 보다 작거나 0으로 잘못 된 매개 변수 처리기를 호출 합니다.실행을 계속 수 있으면 이러한 함수를 설정 errno 에 EINVAL 및-1을 반환 합니다.

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

설명

_snprintf_s 함수의 형식 및 저장소 count 또는 더 적은 문자를 buffer 종료 null을 추가 합니다.각 인수 (있는 경우)를 변환 하 고 출력에서 해당 형식 사양에 따라 format.서식이 일치 하 게 되는 printf 제품군의 기능입니다. see 형식 사양 구문: printf 및 wprintf 함수.중복 문자열 사이의 복사 발생 하는 경우 동작이 정의 되지 않습니다.

경우 count 입니다 _TRUNCATE, 다음 _snprintf_s 에서 적합 한지 최대한 will 문자열로 많이 씁니다 buffer 종료 null에 대 한 공간을 유지 하는 동안.전체 문자열 (종료 null)와 맞는지 buffer, 다음 _snprintf_s (종료 null 포함) 작성; 문자를 반환 합니다. 그렇지 않으면 _snprintf_s 해당 잘라내기 나타내는-1을 반환 합니다.

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

_snwprintf_s와이드 문자 버전입니다 _snprintf_s. 포인터 인수에 _snwprintf_s 와이드 문자 문자열입니다.인코딩 오류를 감지 _snwprintf_s 에 있는 다를 수 있습니다 _snprintf_s._snwprintf_s와 같은 swprintf_s, 대상 형식 대신 문자열 출력 기록 FILE.

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

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

일반 텍스트 루틴 매핑

Tchar.h 루틴	_UNICODE 및 _mbcs가 정의 되지 않았습니다.	_Mbcs가 정의	_Unicode가 정의
_sntprintf_s	_snprintf_s	_snprintf_s	_snwprintf_s
_sntprintf_s_l	_snprintf_s_l	_snprintf_s_l	_snwprintf_s_l

요구 사항

루틴	필수 헤더
_snprintf_s, _snprintf_s_l	<stdio.h>
_snwprintf_s, _snwprintf_s_l	<stdio.h> 또는 <wchar.h>

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

예제

// crt_snprintf_s.cpp
// compile with: /MTd

// These #defines enable secure template overloads
// (see last part of Examples() below)
#define _CRT_SECURE_CPP_OVERLOAD_STANDARD_NAMES 1 
#define _CRT_SECURE_CPP_OVERLOAD_STANDARD_NAMES_COUNT 1

#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <crtdbg.h>  // For _CrtSetReportMode
#include <errno.h>

// This example uses a 10-byte destination buffer.

int snprintf_s_tester( const char * fmt, int x, int count )
{
   char dest[10];

   printf( "\n" );

   if ( count == _TRUNCATE )
      printf( "%d-byte buffer; truncation semantics\n",
               _countof(dest) );
   else
      printf( "count = %d; %d-byte buffer\n",
               count, _countof(dest) );

   int ret = _snprintf_s( dest, _countof(dest), count, fmt, x );

   printf( "    new contents of dest: '%s'\n", dest );

   return ret;
}


void Examples()
{
   // formatted output string is 9 characters long: "<<<123>>>"
   snprintf_s_tester( "<<<%d>>>", 121, 8 );
   snprintf_s_tester( "<<<%d>>>", 121, 9 );
   snprintf_s_tester( "<<<%d>>>", 121, 10 );

   printf( "\nDestination buffer too small:\n" );

   snprintf_s_tester( "<<<%d>>>", 1221, 10 );

   printf( "\nTruncation examples:\n" );

   int ret = snprintf_s_tester( "<<<%d>>>", 1221, _TRUNCATE );
   printf( "    truncation %s occur\n", ret == -1 ? "did"
                                                  : "did not" );

   ret = snprintf_s_tester( "<<<%d>>>", 121, _TRUNCATE );
   printf( "    truncation %s occur\n", ret == -1 ? "did"
                                                  : "did not" );
   printf( "\nSecure template overload example:\n" );

   char dest[10];
   _snprintf( dest, 10, "<<<%d>>>", 12321 );
   // With secure template overloads enabled (see #defines
   // at top of file), the preceding line is replaced by
   //    _snprintf_s( dest, _countof(dest), 10, "<<<%d>>>", 12345 );
   // Instead of causing a buffer overrun, _snprintf_s invokes
   // the invalid parameter handler.
   // If secure template overloads were disabled, _snprintf would
   // write 10 characters and overrun the dest buffer.
   printf( "    new contents of dest: '%s'\n", dest );
}

void myInvalidParameterHandler(
   const wchar_t* expression,
   const wchar_t* function, 
   const wchar_t* file, 
   unsigned int line, 
   uintptr_t pReserved)
{
   wprintf(L"Invalid parameter handler invoked: %s\n", expression);
}

int main( void )
{
   _invalid_parameter_handler oldHandler, newHandler;

   newHandler = myInvalidParameterHandler;
   oldHandler = _set_invalid_parameter_handler(newHandler);
   // Disable the message box for assertions.
   _CrtSetReportMode(_CRT_ASSERT, 0);

   Examples();
}