_sntprintf



_sntprintf是snprintf的ANSI和UNICODE通用定义,

原型：int snprintf(char *str, size_t size, const char *format, ...)

功能：将可变个参数(...)按照format格式化成字符串，然后将其复制到str中

(1) 如果格式化后的字符串长度 < size，则将此字符串全部复制到str中，并给其后添加一个字符串结束符('\0')；

(2) 如果格式化后的字符串长度 >= size，则只将其中的(size-1)个字符复制到str中，并给其后添加一个字符串结束符('\0')，返回值为欲写入的字符串长度。

返回值：若成功则返回欲写入的字符串长度，若出错则返回 负值。

说明：strcpy() sprintf() strcat() 存在安全隐患， 其对应的安全版为：strncpy() snprintf() strncat()

例1：

snprintf(s,100,"%.*S",3,"abcd");
s的值为abc
%.*s 表示有两项， 第一项指定了长度，第二项则是%s的内容，所以取前三位

例2：

char a[20] = {0};
int i = snprintf(a, 9, "%012d", 12345);
printf("i = %d, a = %s", i, a);
输出为：i = 12, a = 00000001

例3：

#include<stdio.h>
#include<stdlib.h>
int main()
{　
  char str[10]={0};
  int nLen=snprintf(str,sizeof(str),"0123456789012345678");
  printf("str=%s\n",str);
  printf("nLen=%d\n",nLen);
  return0;
}
 
运行结果：
str=012345678
nLen=19

其他函数说明：

_snprintf、_snprintf_l、_snwprintf、_snwprintf_l

<strong>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
</strong>

参数

---

buffer

输出的存储位置。

count

可存储的最多字符数。

format

窗体控件字符串。

argument

可选参数。

locale

要使用的区域设置。

返回值

---

将 len 设为格式化数据字符串的长度，不包括终止 null。 对于 _snprintf，len 和 count 以字节为单位，而对于 _snwprintf 则以宽字符为单位。

如果 len < count，len 个字符将存储在 buffer 中，附加 null 终止符，并返回 len。

如果 len = count，len 个字符将存储在 buffer 中，不附加 null 终止符，并返回 len。

如果 len > count，count 个字符将存储在 buffer 中，不附加 null 终止符，并返回负值。

如果 buffer 为 null 指针，并且 count 为零，len 将返回为设置输出格式所需的字符数，不包括终止 null。 若要使用相同的 argument 和 locale 参数进行成功调用，请分配至少容纳 len + 1 个字符的缓冲区。

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

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