C++snprintf的使用

一、定义

众所周知,sprintf不能检查目标字符串的长度，可能造成众多安全问题,所以都会推荐使用snprintf。自从snprintf代替了sprintf，相信大家对snprintf的使用都不会少，函数定义如下：

int snprintf(char*str, size_t size,constchar*format, ...);

C 库函数 int snprintf(char *str, size_t size, const char *format, ...) 设将可变参数(...)，按照 format 格式化成字符串，并将字符串复制到 str 中，size 是要写入的字符的最大数目，超过 size 会被截断。

参数

• str -- 目标字符串。
• size -- 拷贝字节数(Bytes)。
• format -- 格式化成字符串。
• ... -- 可变参数。

返回值

• (1) 如果格式化后的字符串长度小于等于 size，则会把字符串全部复制到 str 中，并给其后添加一个字符串结束符 \0，
• (2) 如果格式化后的字符串长度大于 size，超过 size 的部分会被截断，只将其中的 (size-1) 个字符复制到 str 中，并给其后添加一个字符串结束符 \0，
• (3)返回值为欲写入的字符串长度,若出错则返回负值。

二、实例

 int main()
 {
	 char a[16];
	 size_t i;

	 i = snprintf(a, 13, "%012d", 12345);  // 第 1 种情况,12345复制到数组a中
	 printf("i = %lu, a = %s\n", i, a);    // 输出：i = 12, a = 000000012345, 12位

	 i = snprintf(a, 9, "%012d", 12345);   // 第 2 种情况，超出的截断，只复制1到数组a中
	 printf("i = %lu, a = %s\n", i, a);    // 输出：i = 12, a = 00000001，9位

         return 0;
}

其他例子

 std::string printTime(const timeval &tv) {
	 time_t sec_tmp = tv.tv_sec;
	 struct tm *tm = localtime(&sec_tmp);
	 char buf[128];
	 snprintf(buf, sizeof(buf), "%d-%02d-%02d %02d:%02d:%02d.%03d",
		 1900 + tm->tm_year,
		 1 + tm->tm_mon,
		 tm->tm_mday,
		 tm->tm_hour,
		 tm->tm_min,
		 tm->tm_sec,
		 (int)(tv.tv_usec / 1000));
	 return buf;
 }

另一个例子

假设我想将一个char类型的变量打印成2位的10进制，我应该怎么写呢？

	 size_t i;
	 char a = 'a';
	 char str[20];
	 i=snprintf(str,sizeof(str), "%02d", a);
	 printf("i = %lu, a = %s\n", i, atr);    

运行结果：

解释如下：

size是限定最终生成的dest的字符数,最多拷贝size-1个字符; 一般情况下size会取sizeof(dest),这是为了dest不溢出.

在snprintf(dest, size, "str: %s\n", src)中如果size-1大于等于"str: %s\n"的长度,则把"str: %s\n"都拷贝到dest; 如果size-1小于"str: %s\n"的长度,则从"str: %s\n"拷贝size-1长度的字符串到dst，并且末尾置\0.

就是说，拷贝的长度是size-1和源字符串长度的最小值；

参考：

https://www.cnblogs.com/LifeoFHanLiu/p/10797588.html

https://zhidao.baidu.com/question/681666154238656332.html

https://www.runoob.com/cprogramming/c-function-snprintf.html