函数函数原型为int snprintf(char *str, size_t size, const char *format, ...)
(1) 如果格式化后的字符串长度 < size,则将此字符串全部复制到str中,并给其后添加一个字符串结束符('\0');
(2) 如果格式化后的字符串长度 >= size,则只将其中的(size-1)个字符复制到str中,并给其后添加一个字符串结束符('\0');
(3) 返回值为欲写入的字符串长度。 使用snprintf函数时要注意上面三点。
如下面程序:
char buf[LEN];
int n = snprintf(buf, LEN, "%s%d%s", str1, int2, str3);
printf("total length n %d"\n, n);
如:char buf[8];
int n = snprintf(buf, 5, "abcdefghijk");
printf("n %d buf %s\n", n, buf);
运行结果为: n 11 buf abcd
注意结果只输出了abcd,长度为4,不是5,没有输出 e ,说明snprintf函数最后自动加上去的'\0',是算在size内部的;格式化字符串的总长度不包括'\0',这里使用sizeof(buf)时需要注意+1,这一点与malloc申请空间类似。
总结:
①snprintf函数会自动在格式化后的字符串尾添加\0,结尾符\0是包含在size长度内部的;
②snprintf会在结尾加上\0,不管buf空间够不够用,所以不必担心缓冲区溢出;
③snprintf的返回值n,当调用失败时,n为负数;当调用成功时,n为格式化的字符串的总长度(不包括\0),当然这个字符串有可能被截断,取决于buf的长度是否够放下整个字符串。
if ( n < 0): snprintf出错了;
if ( n >0 && n < sizeof(buf) ) : snprintf成功,并且格式了完整的字符串;
if ( n >= sizeof(buf) ) : snprintf成功,但要格式化的字符串被截断了。