va_start/va_arg/va_end/vsprintf 使用说明(C语言)

void Uart_Printf(char *fmt,...) //...表示可变参数（多个可变参数组成一个列表，后面有专门的指针指向他），不限定个数和类型，

{

  va_list ap;//初始化指向可变参数列表的指针

  char string[256];

  

  va_start(ap,fmt);//将第一个可变参数的地址付给ap，即ap指向可变参数列表的开始

  vsprintf(string,fmt,ap);//将参数fmt、ap指向的可变参数一起转换成格式化字符串，放string数组中，其作用同sprintf，只是参数类型不同

  Uart_SendString(string); //把格式化字符串从开发板串口送出去

  va_end(ap); //ap付值为0，没什么实际用处，主要是为程序健壮性

}

（1）格式化字符串

printf（“%s, %-19s: %6.2”,lastname,firstname,prize）;

打印结果：Bechr，Teddy ；2000.00

我们说“ Bechr，Teddy ；2000.00 ”就是一个格式化字符串，printf的作用就是把（“%s, %-19s: 6.2”,lastname,firstname,prize）翻译成电脑认识的字符串，而对于“%s, %-19s: 6.2”,lastname,firstname,prize电脑根部不认识，故需要printf翻译。

（2）vsprintf

函数名: vsprintf

功 能: 送格式化输出串到指定数组中

用 法: int vsprintf(char *string, char *format, va_list param);

程序例:

----------------------------------------------------------------

#include <stdio.h>

#include <conio.h>

#include <stdarg.h>

char buffer[80];

int vspf(char *fmt, ...)

{

  va_list argptr;

  int cnt;

  

  va_start(argptr, fmt);

  cnt = vsprintf(buffer, fmt, argptr);

  va_end(argptr);

  

  return(cnt);

}

int main(void)

{

  int inumber = 30;

  float fnumber = 90.0;

  char string[4] = "abc";

  

  vspf("%d %f %s", inumber, fnumber, string);

  printf("%s\n", buffer);

  return 0;

}

------------------------------------------------------------------------

vsprintf与sprintf功能是一样的，即把格式化字符串输出到指定数组中，sprintf(char *string, char *farmat [,argument,...])函数的参数从第二个参数开始与printf是一样的，只是sprintf是输出到指定数组中，printf是输出到屏幕（一个标准输出文件），因而sprintf多了char *string这参数。

（3）[转]va_start va_arg va_end 的使用和原理

stdarg.h中查到如下宏定义：

typedef int *va_list[1];//va_list 变量类型定义

#define va_start(ap, parmN) (void)(*(ap) = __va_start(parmN))

#define va_arg(ap, type) __va_arg(*(ap), type)//取可变参数的内容

#define va_end(ap) ((void)(*(ap) = 0))

◎用法:

func( Type para1, Type para2, Type para3, ... )

{

/****** Step 1 ******/

va_list ap;

va_start( ap, para3 ); //一定要“...”之前的那个参数

/****** Step 2 ******/

//此时ap指向第一个可变参数

//调用va_arg取得里面的值

Type xx = va_arg( ap, Type );

//Type一定要相同，如:

//char *p = va_arg( ap, char *);

//int i = va_arg( ap, int );

//如果有多个参数继续调用va_arg，ap会自动变化（一般是自增）

/****** Step 3 ******/

va_end(ap); //For robust!

}

◎研究：（此处的宏定义与前面有些差别可能是OS不同，不用管它，只要能帮助我们理解即可）

typedef char * va_list;

#define va_start _crt_va_start

#define va_arg _crt_va_arg

#define va_end _crt_va_end

#define _crt_va_start(ap,v) ( ap = (va_list)_ADDRESSOF(v) + _INTSIZEOF(v) )

#define _crt_va_arg(ap,t) ( *(t *)((ap += _INTSIZEOF(t)) - _INTSIZEOF(t)) )//注意(ap += _INTSIZEOF(t))括号

#define _crt_va_end(ap) ( ap = (va_list)0 )

va_list argptr;

C语言的函数的参数是从右向左压入堆栈的,调用va_start后，按定义的宏运算，_ADDRESSOF得到v所在的地址，然后这个地址加上v的大小，则使ap指向第一个可变参数如图: 

栈底 高地址

| ....... 

| 函数返回地址

| ....... 

| 函数最后一个参数

| .... 

| 函数第一个可变参数 <--va_start后ap指向

| 函数最后一个固定参数

| 函数第一个固定参数

栈顶 低地址

然后，用va_arg()取得类型t的可变参数值, 先是让ap指向下一个参数:

ap += _INTSIZEOF(t)，然后在减去_INTSIZEOF(t)，使得表达式结果为

ap之前的值，即当前需要得到的参数的地址，强制转换成指向此参数的

类型的指针，然后用*取值

最后，用va_end(ap)，给ap初始化，保持健壮性。

 

小结:  
可变参数的函数原理其实很简单,而va系列是以宏定义来定义的,实现跟堆栈相关.我们写一个可变函数的C函数时,有利也有弊,所以在不必要的场合,我们无需用到可变参数.如果在C++里,我们应该利用C++的多态性来实现可变参数的功能,尽量避免用C语言的方式来实现.