snprintf 函数用法

snprintf()函数用于将格式化的数据写入字符串，其原型为：
    int snprintf(char *str, int n, char * format [, argument, ...]);


【参数】str为要写入的字符串；n为要写入的字符的最大数目，超过n会被截断；format为格式化字符串，与printf()函数相同；argument为变量。


【返回值】成功则返回参数str 字符串长度，失败则返回-1，错误原因存于errno 中。


snprintf()可以认为是sprintf()的升级版，比sprintf()多了一个参数，能够控制要写入的字符串的长度，更加安全，只要稍加留意，不会造成缓冲区的溢出。


snprintf()与sprintf()使用方法类似，请参考：C语言sprintf()函数


注意：snprintf()并不是标C中规定的函数，但是在许多编译器中，厂商提供了其实现的版本。


在GCC中，该函数名称就snprintf()，而在VC中称为_snprintf()。由于不是标准函数，没有一个统一的标准来规定该函数的行为，所以导致了各厂商间的实现版本可能会有差异。


差异发生在参数 n。在GCC中，参数n是要向str写入3个字符，包括'\0'字符；在VC中，参数n是要写入的字符串的总字符数。


在GCC中运行如下程序：
#include <stdio.h>
int main()
{
    char str[5];
    int ret = snprintf(str, 3, "%s", "abcdefg");
    printf("%d\n",ret);
    printf("%s",str);
    return 0;
}
输出：
7
ab


在VC中运行如下程序：
#include <stdio.h>
int main()
{
    char str[5];
    int ret = _snprintf(str,3,"%s","abcdefg");
    printf("%d\n",ret);
    printf("%s",str);
    return 0;
}
输出：
-1
abc

从输出结果可以知道：
GCC中的参数n表示向str中写入n个字符，包括'\0'字符，并且返回实际的字符串长度。
VC中的参数n表示会向str中写入n个字符，不包括'\0'字符，并且不会在字符串末尾添加'\0'符。当字符串长度超过参数n时，函数返回-1，以表示可能导致错误。