C语言中可变参数的用法——va_list、va_start、va_arg、va_end

转载自¹

C语言可变参简介

我们在C语言编程中会遇到一些参数个数可变的函数，例如printf()这个函数，它的定义是这样的：

int printf( const char* format，...);

除了有一个参数format固定以外，后面跟的参数的个数和类型是可变的，例如我们可以有以下不同的调用方法：
printf("%d",i);
printf("%s",s);
printf("the number is %d, string is：%s", i, s);

写一个简单的可变参数C函数

下面我们来探讨如何写一个简单的可变参数的C函数。
写可变参数的C函数要在程序中用到以下这些宏：
void va_start( va_list arg_ptr, prev_param );
type va_arg( va_list arg_ptr, type );
void va_end( va_list arg_ptr );

va在这里是variable-argument(可变参数)的意思。这些宏定义在stdarg.h中，所以用到可变参数的程序应该包含这个头文件。下面我们写一个简单的可变参数的函数，该函数至少有一个整数参数，第二个参数也是整数，是可选的。函数只是打印这两个参数的值。

void simple_va_fun(int i, ...) 
{ 
	va_list arg_ptr; 
	int j=0; 
	
	va_start(arg_ptr, i); 
	j=va_arg(arg_ptr, int); 
	va_end(arg_ptr); 
	
	printf("%d %d\n", i, j); 
	return; 
}

我们可以在我们的头文件中这样声明我们的函数：
extern void simple_va_fun(int i， ...);
我们在程序中可以这样调用：
simple_va_fun(100);
simple_va_fun(100，200);

从这个函数的实现可以看到，我们使用可变参数应该有以下步骤：
1)首先在函数里定义一个va_list型的变量，这里是arg_ptr，这个变量是指向参数的指针。
2)然后用va_start宏初始化变量arg_ptr，这个宏的第二个参数是第一个可变参数的前一个参数，是一个固定的参数。
3)然后用va_arg返回可变的参数，并赋值给整数j。 va_arg的第二个参数是你要返回的参数的类型，这里是int型。
4)最后用va_end宏结束可变参数的获取。然后你就可以在函数里使用第二个参数了。如果函数有多个可变参数的，依次调用va_arg获取各个参数。

如果我们用下面三种方法调用的话，都是合法的，但结果却不一样：

• simple_va_fun(100);
  结果是：100 -123456789(会变的值)
• simple_va_fun(100, 200);
  结果是：100 200
• simple_va_fun(100, 200, 300);
  结果是：100 200

我们看到第一种调用有错误，第二种调用正确，第三种调用尽管结果正确，但和我们函数最初的设计有冲突。下面我们探讨出现这些结果的原因和可变参数在编译器中是如何处理的。

编译器如何处理可变参数

我们知道va_start，va_arg，va_end是在stdarg。h中被定义成宏的，由于1)硬件平台的不同 2)编译器的不同，所以定义的宏也有所不同，下面以VC++中stdarg.h里x86平台的宏定义摘录如下(’\’号表示折行)：

typedef char * va_list; 
#define _INTSIZEOF(n) \ 
(sizeof(n)+sizeof(int)-1)&~(sizeof(int) - 1) ) 

#define va_start(ap, v) ( ap = (va_list)&v + _INTSIZEOF(v) ) 
#define va_arg(ap, t) \ 
( *(t *)((ap += _INTSIZEOF(t)) - _INTSIZEOF(t)) ) 
#define va_end(ap) ( ap = (va_list)0 )

定义_INTSIZEOF(n)主要是为了某些需要内存的对齐的系统。C语言的函数是从右向左压入堆栈的，图(1)是函数的参数在堆栈中的分布位置。我们看到va_list被定义成char*，有一些平台或操作系统定义为void*。再看va_start的定义，定义为&v+_INTSIZEOF(v)，而&v是固定参数在堆栈的地址，所以我们运行va_start(ap， v)以后ap指向第一个可变参数在堆栈的地址，如图：

H     |-----------------------------| 
      |         函数返回地址         | 
      |-----------------------------| 
      |           .......           | 
      |-----------------------------| 
      |   第n个参数(第一个可变参数)   | 
      |-----------------------------|  <--va_start后ap指向 
      | 第n-1个参数(最后一个固定参数) | 
L     |-----------------------------|  <-- &v 
                   图(1) 

然后，我们用va_arg()取得类型t的可变参数值，以上例为int型为例，我们看一下va_arg取int型的返回值：
j= ( *(int*)((ap += _INTSIZEOF(int))-_INTSIZEOF(int)) );

首先ap+=sizeof(int)，已经指向下一个参数的地址了。然后返回ap-sizeof(int)的int*指针，这正是第一个可变参数在堆栈里的地址(图2).然后用*取得这个地址的内容(参数值)赋给j。

H     |-----------------------------| 
      |         函数返回地址         | 
      |-----------------------------| 
      |           .......           | 
      |-----------------------------|  <--va_arg后ap指向 
      |   第n个参数(第一个可变参数)   | 
      |-----------------------------|  <--va_start后ap指向 
      | 第n-1个参数(最后一个固定参数) | 
L     |-----------------------------|  <-- &v 
                   图(2) 

最后要说的是va_end宏的意思，x86平台定义为ap=(char*)0;使ap不再指向堆栈，而是跟NULL一样.有些直接定义为((void*)0)，这样编译器不会为va_end产生代码，例如gcc在linux的x86平台就是这样定义的。在这里大家要注意一个问题：由于参数的地址用于va_start宏，所以参数不能声明为寄存器变量或作为函数或数组类型。关于va_start， va_arg， va_end的描述就是这些了，我们要注意的是不同的操作系统和硬件平台的定义有些不同，但原理却是相似的。

可变参数在编程中要注意的问题

因为va_start， va_arg， va_end等定义成宏，所以它显得很愚蠢，可变参数的类型和个数完全在该函数中由程序代码控制，它并不能智能地识别不同参数的个数和类型。有人会问：printf中不是实现了智能识别参数吗?那是因为函数printf是从固定参数format字符串来分析出参数的类型，再调用va_arg的来获取可变参数的。也就是说，你想实现智能识别可变参数的话是要通过在自己的程序里作判断来实现的。另外有一个问题，因为编译器对可变参数的函数的原型检查不够严格，对编程查错不利。如果simple_va_fun()改为：

void simple_va_fun(int i， ...) 
{ 
	va_list arg_ptr; 
	char *s=NULL;
	
	va_start(arg_ptr, i); 
	s=va_arg(arg_ptr, char*); 
	va_end(arg_ptr); 
	printf("%d %s\n", i, s); 
	return; 
}

可变参数为char*型，当我们忘记用两个参数来调用该函数时，就会出现core dump(Unix) 或者页面非法的错误(window平台)。但也有可能不出错，但错误却是难以发现，不利于我们写出高质量的程序。
以下提一下va系列宏的兼容性。System V Unix 把 va_start定义为只有一个参数的宏：
va_start(va_list arg_ptr);
而ANSI C则定义为：
va_start(va_list arg_ptr, prev_param);

如果我们要用system V的定义，应该用vararg.h头文件中所定义的宏，ANSI C的宏跟system V的宏是不兼容的，我们一般都用ANSI C，所以用ANSI C的定义就够了，也便于程序的移植。

小结：

• 标准C库的中的三个宏的作用只是用来确定可变参数列表中每个参数的内存地址，编译器是不知道参数的实际数目的。
• 在实际应用的代码中，程序员必须自己考虑确定参数数目的办法，如
  ⑴在固定参数中设标志，printf函数就是用这个办法。
  ⑵在预先设定一个特殊的结束标记，就是说多输入一个可变参数，调用时要将最后一个可变参数的值设置成这个特殊的值，在函数体中根据这个值判断是否达到参数的结尾。本文前面的代码就是采用这个办法。无论采用哪种办法，程序员都应该在文档中告诉调用者自己的约定。
• 实现可变参数的要点就是想办法取得每个参数的地址，取得地址的办法由以下几个因素决定：
  ①函数栈的生长方向
  ②参数的入栈顺序
  ③CPU的对齐方式
  ④内存地址的表达方式
  结合源代码，我们可以看出va_list的实现是由④决定的，_INTSIZEOF(n)的引入则是由③决定的，它和①②又一起决定了va_start的实现，最后va_end的存在则是良好编程风格的体现，将不再使用的指针设为NULL，这样可以防止以后的误操作。
• 取得地址后，再结合参数的类型，程序员就可以正确的处理参数了。理解了以上要点，相信稍有经验的读者就可以写出适合于自己机器的实现来。

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

---

1. https：//blog.csdn.net/edonlii/article/details/8497704 ↩︎