_snprintf_s, _snprintf_s_l, _snwprintf_s, _snwprintf_s_l
서식이 지정 된 데이터 문자열을 씁니다.이러한 버전의 있습니다 _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();
}
해당 .NET Framework 항목
해당 사항 없음. 표준 C 함수를 호출할 수 있습니다 PInvoke. 자세한 내용은 플랫폼 호출 예제.
참고 항목
참조
sprintf, _sprintf_l, swprintf, _swprintf_l, __swprintf_l
않는다면, _fprintf_l, fwprintf, _fwprintf_l
printf, _printf_l, wprintf, _wprintf_l
scanf, _scanf_l, wscanf, _wscanf_l