_snprintf， _snprintf_l， _snwprintf， _snwprintf_l

项目
02/21/2013

向字符串写入设置数据格式。这些功能的更安全版本可用; _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
使用的区域设置。

有关更多信息，请参见格式规范。

返回值

允许 len 是设置数据格式字符串的长度 (不包括终止 null)。len 和 count 在 _snprintf的字节， _snwprintf的宽字符。

如果 len AMP_LT count， len 字符在 buffer然后存储， null 结束符追加，并且， len 返回。

如果 len = count， len 字符在 buffer然后存储， null 结束符不是追加，并且， len 返回。

如果 len AMP_GT count， count 字符在 buffer然后存储， null 结束符不是追加，并且，负值返回。

如果 buffer 是 null 指针，并 count 不为零，或 format 是 null 指针，无效参数调用处理程序，如参数验证所述。如果执行允许继续，这些函数返回 -1 并将 errno 到 EINVAL。

有关这些属性和其他错误代码的信息，请参见 _doserrno、 errno、 _sys_errlist 和 _sys_nerr。

备注

，如果格式字符串的长度比 count 字符，严格小于 _snprintf 函数在 buffer设置格式并存储 count 或少量字符，并追加一个 null 字符)。每 argument (如果有) 基于在 format相应的格式规范转换和输出。该格式包括普通字符并具有窗体和功能和 printf的 format 参数相同。如果复制出现在重叠的字符串之间，该行为不确定。

安全说明
确保 format 不是用户定义的字符串。由于此功能不保证 NULL 终止 (特别是，那么，当返回值是 count)，请确保已通过将 null 结束符的代码执行。有关更多信息，请参见避免缓冲区溢出。

_snwprintf 是 _snprintf的宽字符版本;为 _snwprintf 的指针参数是宽字符字符串。编码错误的检测到 _snwprintf 的可能与在 _snprintf。_snwprintf，如 swprintf，对一个字符串写入输出而不是类型 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;
}