vsnprintf_s, _vsnprintf_s, _vsnprintf_s_l, _vsnwprintf_s_vsnwprintf_s_l

인수 목록에 대한 포인터를 사용하여 형식이 지정된 출력값을 씁니다. 이러한 함수는 vsnprintf 설명된 대로 보안 기능이 향상된 , , _vsnprintf, _vsnprintf_l의 _vsnwprintf버전입니다_vsnwprintf_l.

문법

int vsnprintf_s(
   char *buffer,
   size_t sizeOfBuffer,
   size_t count,
   const char *format,
   va_list argptr
);

int _vsnprintf_s(
   char *buffer,
   size_t sizeOfBuffer,
   size_t count,
   const char *format,
   va_list argptr
);

int _vsnprintf_s_l(
   char *buffer,
   size_t sizeOfBuffer,
   size_t count,
   const char *format,
   _locale_t locale,
   va_list argptr
);

int _vsnwprintf_s(
   wchar_t *buffer,
   size_t sizeOfBuffer,
   size_t count,
   const wchar_t *format,
   va_list argptr
);

int _vsnwprintf_s_l(
   wchar_t *buffer,
   size_t sizeOfBuffer,
   size_t count,
   const wchar_t *format,
   _locale_t locale,
   va_list argptr
);

template <size_t size>
int _vsnprintf_s(
   char (&buffer)[size],
   size_t count,
   const char *format,
   va_list argptr
); // C++ only

template <size_t size>
int _vsnwprintf_s(
   wchar_t (&buffer)[size],
   size_t count,
   const wchar_t *format,
   va_list argptr
); // C++ only

매개 변수

buffer
출력을 위한 저장 위치입니다.

sizeOfBuffer
for 출력의 buffer 크기입니다. 를 사용하는 함수에 대한 크기(바이트)와 를 사용하는 char함수에 대한 wchar_t입니다.

count
종료를 NULL포함하지 않는 쓸 최대 문자 수입니다. 를 사용하는 wchar_t함수의 경우 쓸 와이드 문자의 수입니다. 또는 _TRUNCATE.

format
형식 사양.

argptr
인수 목록에 대한 포인터입니다.

locale
출력의 형식을 지정할 때 사용할 로캘입니다.

자세한 내용은 형식 사양을 참조하세요.

반환 값

쓰여진 문자의 수로, terminating NULL를 포함하지 않거나 출력 오류가 발생하는 경우 음수 값입니다.

자세한 내용은 동작 요약을 참조하세요.

비고

이러한 각 함수는 인수 목록에 대한 포인터를 취한 다음 지정된 count 데이터의 문자를 형식이 지정된 메모리에 기록 buffer 하고 종료 NULL를 추가합니다.

디버그 빌드에서 종료 sizeOfBuffer 이후의 나머지 NULL 바이트는 에 _CrtSetDebugFillThreshold설명된 대로 'xFE'로 채워집니다.

접미사가 있는 _l 이러한 함수의 버전은 현재 스레드 locale 대신 전달된 locale 매개 변수를 사용한다는 점을 제외하고는 동일합니다.

vsnprintf_s _vsnprintf_s ANSI 표준을 준수하기 위해 포함되며 동일합니다. _vnsprintf 는 이전 버전과의 호환성을 위해 유지됩니다.

동작 요약

다음 표의 경우:

• len 형식이 지정된 데이터의 크기를 지정합니다. 함수가 버퍼를 char 사용하는 경우 크기는 바이트 단위입니다. 함수가 버퍼를 wchar_t 사용하는 경우 크기는 16비트 단어 수를 지정합니다.
• 문자는 버퍼를 char 사용하는 char 함수의 문자와 버퍼를 wchar_t 사용하는 wchar_t 함수의 문자를 참조합니다.
• 잘못된 매개 변수 처리기에 대한 자세한 내용은 매개 변수 유효성 검사를 참조 하세요.

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

C++에서는 이러한 함수를 사용하는 것이 템플릿 오버로드에 의해 단순화됩니다. 오버로드는 버퍼 길이를 자동으로 추론할 수 있으며(size 인수를 지정할 필요가 없음) 이전의 안전하지 않은 함수를 더 새롭고 안전한 함수로 자동으로 바꿀 수 있습니다. 자세한 내용은 안전한 템플릿 오버로드를 참조하세요.

일반 텍스트 루틴 매핑

요구 사항

* UNIX V 호환성을 위해 필요합니다.

호환성에 대한 자세한 내용은 호환성을 참조하세요.

예시

// crt_vsnprintf_s.cpp
#include <stdio.h>
#include <wtypes.h>

void FormatOutput(LPCSTR formatstring, ...)
{
   int nSize = 0;
   char buff[10];
   memset(buff, 0, sizeof(buff));
   va_list args;
   va_start(args, formatstring);
   nSize = vsnprintf_s( buff, _countof(buff), _TRUNCATE, formatstring, args);
   printf("nSize: %d, buff: %s\n", nSize, buff);
   va_end(args);
}

int main() {
   FormatOutput("%s %s", "Hi", "there");
   FormatOutput("%s %s", "Hi", "there!");
   FormatOutput("%s %s", "Hi", "there!!");
}

nSize: 8, buff: Hi there
nSize: 9, buff: Hi there!
nSize: -1, buff: Hi there!

참고하십시오

스트림 I/O
vprintf 함수
fprintf, _fprintf_l, fwprintf_fwprintf_l
printf, _printf_l, wprintf_wprintf_l
sprintf, _sprintf_l, swprintf, _swprintf_l__swprintf_l
va_arg, va_copy, va_endva_start