_snprintf, _snprintf_l, _snwprintf, _snwprintf_l

아티클
06/09/2015

문자열에 서식이 지정된 데이터를 씁니다. 이러한 기능의 더 안전한 버전을 사용할 수 있습니다. _snprintf_s, _snprintf_s_l, _snwprintf_s, _snwprintf_s_l를 참조하십시오.

int _snprintf(
   char *buffer,
   size_t count,
   const char *format [,
   argument] ... 
);
int _snprintf_l(
   char *buffer,
   size_t count,
   const char *format,
   locale_t locale [,
   argument] ... 
);
int _snwprintf(
   wchar_t *buffer,
   size_t count,
   const wchar_t *format [,
   argument] ... 
);
int _snwprintf_l(
   wchar_t *buffer,
   size_t count,
   const wchar_t *format,
   locale_t locale [,
   argument] ... 
);
template <size_t size>
int _snprintf(
   char (&buffer)[size],
   size_t count,
   const char *format [,
   argument] ... 
); // C++ only
template <size_t size>
int _snprintf_l(
   char (&buffer)[size],
   size_t count,
   const char *format,
   locale_t locale [,
   argument] ... 
); // C++ only
template <size_t size>
int _snwprintf(
   wchar_t (&buffer)[size],
   size_t count,
   const wchar_t *format [,
   argument] ... 
); // C++ only
template <size_t size>
int _snwprintf_l(
   wchar_t (&buffer)[size],
   size_t count,
   const wchar_t *format,
   locale_t locale [,
   argument] ... 
); // C++ only

매개 변수

buffer
출력을 위한 저장소 위치입니다.
count
저장할 최대 문자 수입니다.
format
형식 컨트롤 문자열입니다.
argument
선택적 인수입니다.
locale
사용할 로캘입니다.

자세한 내용은 형식 사양 구문: printf 및 wprintf 함수을 참조하십시오.

반환 값

len은 종료 null을 포함하지 않는 데이터 형식이 지정된 문자열의 길이입니다. len 및 count는 _snprintf의 경우 바이트이고, _snwprintf의 경우 와이드 문자입니다.

len < count, len 문자가 buffer에 저장되는 경우 null 종결자가 추가되고 len이 반환됩니다.

len = count, len 문자가 buffer에 저장되는 경우 null 종결자가 추가되지 않고 len이 반환됩니다.

len > count, count 문자가 buffer에 저장되는 경우 null 종결자가 추가되지 않고 음수 값이 반환됩니다.

buffer가 null 포인터이고 count가 0인 경우 종료 null을 포함하지 않고 출력 형식을 지정하는 데 필요한 문자의 개수로 len이 반환됩니다. 동일한 argument 및 locale 매개 변수를 사용하여 성공적으로 호출하려면 최소한 len + 1자로 보유되는 버퍼를 할당합니다.

buffer가 null 포인터이고 count가 0이 아닌 경우 또는 format이 null 포인터인 경우 매개 변수 유효성 검사에 설명된 대로 잘못된 매개 변수 처리기가 호출됩니다. 계속해서 실행하도록 허용된 경우 이러한 함수가 -1을 반환하고 errno를 EINVAL로 설정합니다.

이러한 오류 코드 및 기타 오류 코드에 대한 자세한 내용은 errno, _doserrno, _sys_errlist 및 _sys_nerr을 참조하십시오.

설명

_snprintf 함수가 형식을 지정하고 buffer에 count자 미만의 문자를 저장하며, 형식이 지정된 문자열 길이가 count자보다 적은 경우 종료 null 문자를 추가합니다. 각 argument(있는 경우)가 format의 해당 형식 사양에 따라 변환되어 출력됩니다. 형식은 일반 문자로 구성되어 있으며, printf를 위한 format 인수와 동일한 형태와 기능을 가지고 있습니다. 중복되는 문자열 간에 복사가 이뤄지면 이 동작은 정의되지 않습니다.

보안 정보
format이 사용자 정의 문자열이 아닌지 확인하십시오.이 함수는 NULL 종료를 보장하지 않으므로, 특히 반환 값이 count이면 해당 값 뒤에 null 종결자를 추가하는 코드가 오는지 확인합니다.자세한 내용은 버퍼 오버런 방지를 참조하십시오.

_snwprintf는 _snprintf의 와이드 문자 버전이며, _snwprintf에 대한 포인터 인수는 와이드 문자 문자열입니다. _snwprintf에서 인코딩 오류의 탐지 방식은 _snprintf에서와 다를 수 있습니다. swprintf와 같이 _snwprintf가 FILE 유형의 대상 대신 문자열에 출력을 기록합니다.

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

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

제네릭 텍스트 라우팅 매핑

Tchar.h 루틴	_UNICODE 및 _MBCS 정의되지 않음	_MBCS 정의됨	_UNICODE 정의됨
_sntprintf	_snprintf	_snprintf	_snwprintf
_sntprintf_l	_snprintf_l	_snprintf_l	_snwprintf_l

요구 사항

루틴	필수 헤더
_snprintf, _snprintf_l	<stdio.h>
_snwprintf, _snwprintf_l	<stdio.h> 또는 <wchar.h>

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

예제

// crt_snprintf.c
// compile with: /W3
#include <stdio.h>
#include <stdlib.h>

#if !defined(__cplusplus)
typedef int bool;
const bool true = 1;
const bool false = 0;
#endif

#define FAIL 0 // change to 1 and see what happens

int main(void)
{
   char buffer[200];
   const static char s[] = "computer"
#if FAIL
"computercomputercomputercomputercomputercomputercomputercomputer"
"computercomputercomputercomputercomputercomputercomputercomputer"
"computercomputercomputercomputercomputercomputercomputercomputer"
"computercomputercomputercomputercomputercomputercomputercomputer"
#endif
   ;
   const char c = 'l'; 
   const int i = 35;
#if FAIL
   const double fp = 1e300; // doesn't fit in the buffer
#else
   const double fp = 1.7320534;
#endif
   /* !subtract one to prevent "squeezing out" the terminal nul! */
   const int bufferSize = sizeof(buffer)/sizeof(buffer[0]) - 1;
   int bufferUsed = 0;
   int bufferLeft = bufferSize - bufferUsed;
   bool bSuccess = true;
   buffer[0] = 0;

   /* Format and print various data: */

   if (bufferLeft > 0)
   {
      int perElementBufferUsed = _snprintf(&buffer[bufferUsed], 
      bufferLeft, "   String: %s\n", s ); // C4996
      // Note: _snprintf is deprecated; consider _snprintf_s instead
      if (bSuccess = (perElementBufferUsed >= 0))
      {
         bufferUsed += perElementBufferUsed;
         bufferLeft -= perElementBufferUsed;
         if (bufferLeft > 0)
         {
            int perElementBufferUsed = _snprintf(&buffer[bufferUsed], 
            bufferLeft, "   Character: %c\n", c ); // C4996
            if (bSuccess = (perElementBufferUsed >= 0))
            {
               bufferUsed += perElementBufferUsed;
               bufferLeft -= perElementBufferUsed;
               if (bufferLeft > 0)
               {
                  int perElementBufferUsed = _snprintf(&buffer
                  [bufferUsed], bufferLeft, "   Integer: %d\n", i ); // C4996
                  if (bSuccess = (perElementBufferUsed >= 0))
                  {
                     bufferUsed += perElementBufferUsed;
                     bufferLeft -= perElementBufferUsed;
                     if (bufferLeft > 0)
                     {
                        int perElementBufferUsed = _snprintf(&buffer
                        [bufferUsed], bufferLeft, "   Real: %f\n", fp ); // C4996
                        if (bSuccess = (perElementBufferUsed >= 0))
                        {
                           bufferUsed += perElementBufferUsed;
                        }
                     }
                  }
               }
            }
         }
      }
   }

   if (!bSuccess)
   {
      printf("%s\n", "failure");
   }
   else
   {
      /* !store nul because _snprintf doesn't necessarily (if the string 
       * fits without the terminal nul, but not with it)!
       * bufferUsed might be as large as bufferSize, which normally is 
       * like going one element beyond a buffer, but in this case 
       * subtracted one from bufferSize, so we're ok.
       */
      buffer[bufferUsed] = 0;
      printf( "Output:\n%s\ncharacter count = %d\n", buffer, bufferUsed );
   }
   return EXIT_SUCCESS;
}