通俗易懂说：snprintf scnprintf

通俗易懂说：snprintf scnprintf

• 1. snprintf
• • 1.1 原型
  • 1.2 参数：
  • 1.3 返回值：
  • 1.4 【snprintf 正确用法】
• 2. scnprintf - 非 linux函数
• • 2.1 原型
  • 2.2 参数：
  • 2.3 返回值：
  • 2.4 scnprintf 实现 - 非linux 函数
• 3. 区别：
• 4. 例子

1. snprintf

1.1 原型

int snprintf(char *buff, size_t size, const char *format, …)

1.2 参数：

buff： 用于保存格式化输出的缓冲区
size：格式化输出缓冲区长度
format：格式化输出的格式
……： 表示可参数扩展，根据format确定

1.3 返回值：

该接口返回的长度是源字符串的长度，并不是实际写入的字符串长度。
即： 格式化后字符串的长度，返回值可能比传入的size大。

1.4 【snprintf 正确用法】

第二个参数为目的缓冲区的剩余空间大小。

由于该接口返回的长度是源字符串的长度，并不是实际写入的字符串长度。
故该接口不适合累加拼装，仅用于单次拼装。

CHAR  szTest[STR_LENGTH + 1];  
snprintf(szTest, sizeof(szTest), "%s-%d", "911Car", 911);

2. scnprintf - 非 linux函数

2.1 原型

int scnprintf(char *dest, size_t size, const char *format, …)

2.2 参数：

dest： 用于保存格式化输出的缓冲区
size：格式化输出缓冲区长度
format：格式化输出的格式
……： 表示可参数扩展，根据format确定

2.3 返回值：

返回实际拷入dest的字符串的长度，不包括 ‘\o'结束符。

2.4 scnprintf 实现 - 非linux 函数

man中没有

#include <>
#include <>
#include <>
#include <>

INT scnprintf(OUT CHAR *pcBuf, IN size_t ulSize, IN const CHAR *pcFmt,...)
{
	va_list args;
	INT iRetLen = 0;

	va_start(args, pcFmt);
	iRetLen = vsnprintf(pcBuf, ulSize, pcFmt, args);
	va_end(args);

	return ((iRetLen >= (INT)(UINT)ulSize) ? ((INT)(UINT)ulSize - 1) : iRetLen);
}

3. 区别：

返回值的不同：

1. snprintf 返回源字符串的长度，可能比目标缓冲区大
2. scnprintf 返回实际拷入目标缓冲区的长度，不包括\0

4. 例子

	char szBuf[10] = {0};
	int iLen = snprintf(szBuf,sizeof(szBuf),"123456789abcde");
	printf("After snprintf the buf is "%s \n iLen is %d\n",szBuf,iLen);
	结果：After snprintf the buf is 123456789
			 iLen is 14
			 
	//scnprintf 需要自己实现，非linux库函数
	int iLen = scnprintf(szBuf,sizeof(szBuf),"123456789abcde");
	printf("After scnprintf the buf is "%s\n iLen is %d\n",szBuf,iLen);
	结果：After scnprintf the buf is 123456789
			 iLen is 9

或：

char acStr[128] = "1234567890";
int iIndex = 100;
scnprintf(szBuf, sizeof(szBuf), "%s.%02d", acStr, iIndex );