通俗易懂说:snprintf scnprintf

时间:2025-02-12 09:17:48

通俗易懂说: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 );