话说这是第一次见。。。感觉自己太菜了
功能
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只有三个参数,第三个参数是参数化列表,所以要传递的参数都在列表里。
好,本文结束