[转载]C库函数sprintf、vsprintf及\r\n的使用

话说这是第一次见。。。感觉自己太菜了

功能

C库函数 int vsprintf（char *str，const char *format，va_list arg）使用 参数列表格式化 输出到字符串

参数

• str 指向一个字符串数组的指针
• format 这是一个字符串，包含了要被写入到字符串str的文本（format可以是包含嵌入的format标签，这些标签可以被随后的附加参数中指定的值替换，并按需格式化）

format具体讲解

一般形式：%[flags][width][.precision][length]specifier
specifier为必选参数，跟我们常用的printf参数没什么两样，比如%d表示十进制数，%c表示字符。具体细节如下表：

specifier	释义
c	字符
s	字符串
f	浮点数
d or i	有符号十进制数
u	无符号十进制
o	有符号八进制
p	指针地址
n	无输出
%	字符百分号%输出
x or X	有符号十六进制小写或者大写
e or E	使用e字符或者E字符的科学记数法
g 或者G	根据数值不同，自动选择%e or %G 或者%f记数法

其余为可选参数，不显示声明，则默认缺省。以下一一介绍：

flags	释义
-	在给定的字段宽度内左对齐，缺省值 右对齐
+	强制在输出结果前加上符号位，正数带+，负数带-，缺省值 只有负数带-，正数不带+
(space)	如果没有写入任何符号，则在该值前面插入一个空格
#	与 o、x 或 X 说明符一起使用时，非零值前面会分别显示 0、0x 或 0X，缺省不显示。与 e、E 和 f 一起使用时，会强制输出包含一个小数点，即使后边没有数字时也会显示小数点。缺省，如果后边没有数字时候，不会显示显示小数点。与 g 或 G 一起使用时，结果与使用 e 或 E 时相同，但是尾部的零不会被移除
0	在指定填充padding的数字左边放置0，而不是空格

width	释义
(number)	要输出的字符最小数目。如果输出的值短于该数，结果用空格填充。如果输出的值长于该数，结果不截断
*	宽度在format字符串中未指定，但是会作为附加整数值参数放置与要被格式化的参数之前

precision	释义
.number	对于整数说明符（d、i、o、u、x、X）：precision 指定了要写入的数字的最小位数。如果写入的值短于该数，结果会用前导零来填充。如果写入的值长于该数，结果不会被截断。精度为 0 意味着不写入任何字符。 对于 e、E 和 f 说明符：指定要在小数点后输出的小数位数。 对于 g 和 G 说明符：指定要输出的最大有效位数。 对于 s: 指定要输出的最大字符数。 默认情况下，所有字符都会被输出，直到遇到末尾的空字符。 对于 c 类型：没有任何影响。如果指定时不带有一个显式值，则假定为 0。当未指定任何精度时，缺省为 1
*	精度在 format 字符串中未指定，但是会作为附加整数值参数放置于要被格式化的参数之前

length	释义
h	参数被解释为短整型或无符号短整型（仅适用于整数说明符：i、d、o、u、x 和 X）
l	参数被解释为长整型或无符号长整型，适用于整数说明符（i、d、o、u、x 和 X）及说明符 c（表示一个宽字符）和 s（表示宽字符字符串）
L	参数被解释为长双精度型（仅适用于浮点数说明符：e、E、f、g 和 G）

返回值

如果成功，则返回写入的字符总数，否则返回负数

示例

#include <stdio.h>
#include <stdarg.h>

char buffer[80];
int vspfunc(char *format, ...)
{
   va_list aptr;
   int ret;

   va_start(aptr, format);
   ret = vsprintf(buffer, format, aptr);
   va_end(aptr);

   return(ret);
}

int main()
{
   int i = 5;
   float f = 27.0;
   char str[50] = "runoob.com";

   vspfunc("%d %f %s", i, f, str);
   printf("%s\n", buffer);
   
   return(0);
}

输出结果

5 27.000000 runoob.com

附上转载链接，侵权必删除
http://www.runoob.com/cprogramming/c-function-vsprintf.html

然而

我在VS2017中运行上述代码，直接报错

error C3861: “va_start”: 找不到标识符
error C3861: “va_end”: 找不到标识符

缺少头文件，补上#include "stdafx.h"
继续运行，还有错

error C4996: 'vsprintf': This function or variable may be unsafe. Consider using vsprintf_s instead
error C2664: “int vspfunc(char *,...)”: 无法将参数 1 从“const char [9]”转换为“char *”

见名知意，修改后成功运行：

#include <stdio.h>
#include <stdarg.h>
#include "stdafx.h"
#include "string.h"

char buffer[80];
int vspfunc(const char *format, ...)
{
	va_list aptr;
	int ret;

	va_start(aptr, format);
	ret = vsprintf_s(buffer, format, aptr);
	va_end(aptr);

	return(ret);
}

int main()
{
	int i = 5;
	float f = 27.0;
	char str[50] = "runoob.com";

	vspfunc("%d %f %s", i, f, str);
	printf("%s\n", buffer);

	return(0);
}

谈点业务需求

在某项目中，抽出代码如下：

#include <stdio.h>
#include <stdarg.h>	 
#include "string.h"	
#include "stdafx.h"
char buffer[80];
int vspfunc(const char *format, ...)
{
	va_list aptr;
	int ret;

	va_start(aptr, format);
	ret = vsprintf_s(buffer, format, aptr);
	va_end(aptr);

	return(ret);
}

int main()
{
	int i = 5;
	float f = 27.0;
	char str[50] = "runoob.com";
	//只是简单地%s
	vspfunc("%s\r\n", str);//断点1
	printf("%s\n", buffer);

	return(0);//断点2
}

打断点，分别看中间数据，在断点1处str内容如下：

在断点2处str内容如下：

研究了代码后发现，这不是多此一举么，你直接

strcat_s(str, "\r\n");
printf("%s\n", str);

单用%s确实多此一举。但是，这个vsprintf_s强悍在可以把多种格式数据，按既定要求整到一个字符串里，这就牛逼了，免去了非字串类型到字串类型的繁琐转换

sprintf说几句

其实，可以看到vsprintf只有三个参数，在函数vspfunc内部，第三个参数是指向格式化参数队列的指针。实际上，该指针指向在堆栈中供函数调用的变量。va_list、va_start和va_end宏（在STDARG.H中定义）帮助我们处理堆栈指针。va_start宏将pArg设置为指向一个堆栈变量，该变量位址在堆栈参数szFormat的上面。而上文中vspfunc做的事情，就是sprintf的基础定义：

int sprintf (char * szBuffer, const char * szFormat, ...)
{
int     iReturn ;
va_list pArgs ;
va_start (pArgs, szFormat) ;
iReturn = vsprintf (szBuffer, szFormat, pArgs) ;
va_end (pArgs) ;
return iReturn ;
}

sprintf与vsprintf前两个参数都一样，只不过sprintf后面的参数可以是多个，而vsprintf只有三个参数，第三个参数是参数化列表，所以要传递的参数都在列表里。

好，本文结束