关闭

stdarg.h简介

标签: listfunction编译器funvariablesreturning
653人阅读 评论(0) 收藏 举报

Nehe13课有一个例子

GLvoid glPrint(const char *fmt,...)			//自定义GL输出字体函数文字被存储在字符串 * fmt中
{
	char text[256];							//保存文字串
	va_list ap;								//指向一个变量列表的指针VariantArgument
	if (fmt==NULL)
	{
		return;
	}
	va_start(ap,fmt);						//分析可变参数
	vsprintf(text,fmt,ap);					//把参数值写入字符串
	va_end(ap);								//结束分析

	glPushAttrib(GL_LIST_BIT);				// 把显示列表属性压入属性堆栈
	glListBase(base - 32);					// 设置显示列表的基础值
	glCallLists(strlen(text), GL_UNSIGNED_BYTE, text);		// 调用显示列表绘制字符串
	glPopAttrib();						// 弹出属性堆栈


}

glPrint("Active OpenGL Text With NeHe - %7.2f", cnt1);		// 输出文字到屏幕

/*是一个记号,表示不要把7.2f本身显示在屏幕上,因为它代表一个变量。7表示小数点左边最多有7位数字。然后是小数部分,小数点右边的2表示小数点右边最多保留两位小数。最后,f表示我们想要显示的数字类型为浮点型。*/


我们在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++里不存在,因为C++具有多态性.但C++是C的一个 
超集,以下的技术也可以用于C++的程序中.限于本人的水平,文中如果有 
不当之处,请大家指正. 

(一)写一个简单的可变参数的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获 
取各个参数. 
如果我们用下面三种方法调用的话,都是合法的,但结果却不一样: 
1)simple_va_fun(100); 
结果是:100 -123456789(会变的值) 
2)simple_va_fun(100,200); 
结果是:100 200 
3)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指向第一个可变参数在堆 
栈的地址,如图: 

高地址|-----------------------------| 
|函数返回地址 | 
|-----------------------------| 
|....... | 
|-----------------------------| 
|第n个参数(第一个可变参数) | 
|-----------------------------|<--va_start后ap指向 
|第n-1个参数(最后一个固定参数)| 
低地址|-----------------------------|<-- &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. 

高地址|-----------------------------| 
|函数返回地址 | 
|-----------------------------| 
|....... | 
|-----------------------------|<--va_arg后ap指向 
|第n个参数(第一个可变参数) | 
|-----------------------------|<--va_start后ap指向 
|第n-1个参数(最后一个固定参数)| 
低地址|-----------------------------|<-- &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的定义就够了,也便于程序的移植. 


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

 

 

================================================================

// stdarg.h

 

typedef char *  va_list;

#define _ADDRESSOF(v)   ( &(v) )
#define _INTSIZEOF(n)   ( (sizeof(n) + sizeof(int) - 1) & ~(sizeof(int) - 1) )

#define va_start(ap,v)  ( ap = (va_list)_ADDRESSOF(v) + _INTSIZEOF(v) )
#define va_arg(ap,t)    ( *(t *)((ap += _INTSIZEOF(t)) - _INTSIZEOF(t)) )
#define va_end(ap)      ( ap = (va_list)0 )
void va_copy(va_list    dest,  va_list src);
示例:

#pragma once

/*     stdafx.h  */
#include <stdarg.h>
#define INTARG  1
#define DBLARG  2

/*   stdafx.cpp  */

#include "stdafx.h"

extern void printargs(int *argtypep,...)
{
    va_list ap;  //   
    int argtype;
    va_start(ap,argtypep);// 初始化状态变量ap,要先调用之后才能调用
 //va_arg  与 va_end.argtypep指向最后一个固定参数名,将ap中的
 //内部指针指向传入函数的第一个可变参数
    while((argtype=*argtypep++)!=0)
    {
        switch(argtype)
  {
  case INTARG:
   printf("int: %d/n",va_arg(ap,int));
             //va_arg返回第一个可变参数的值,将内部参
//数指针(在ap中)移到下一个参数,如果有;下一个参数的类型要用type指
//定,使va_arg能够计算其在堆栈中的长度,调用va_start之后第一次调用
//va_arg返回第一个可变参数的值。
   break;
  case DBLARG:
   printf("double: %f/n",va_arg(ap,double));
   break;
  }
      }
 
 va_end(ap); //这个函数或宏在用va_arg读取所有参数之后调用
                //对ap和va_list进行必要的整理操作
 return ;
}
/*    test.cpp   */
#include "stdafx.h"

void printargs(int *argtypep,...);
int arg_types[]={INTARG,DBLARG,INTARG,DBLARG,0};
int _tmain(int argc, _TCHAR* argv[])
{
 printargs(arg_types,1,2.0,3,4.0);
 return 0;
}

 

 

===================================================================

 

2.10 stdarg.h

The stdarg header defines several macros used to get the arguments in a function when the number of arguments is not known.

Macros:

va_start();
va_arg();
va_end();

Variables:

typedef va_list

2.10.1 Variables and Definitions

The va_list type is a type suitable for use in accessing the arguments of a function with the stdarg macros.

A function of variable arguments is defined with the ellipsis (,...) at the end of the parameter list.

2.10.2 va_start

Declaration:

void va_start(va_list ap, last_arg);

Initializes ap for use with the va_arg and va_end macros. last_arg is the last known fixed argument being passed to the function (the argument before the ellipsis).

Note that va_start must be called before using va_arg and va_end.

2.10.3 va_arg

Declaration:

type va_arg(va_list ap, type);

Expands to the next argument in the paramater list of the function with type type. Note that ap must be initialized with va_start. If there is no next argument, then the result is undefined.

2.10.4 va_end

Declaration:

void va_end(va_list ap);

Allows a function with variable arguments which used the va_start macro to return. If va_end is not called before returning from the function, the result is undefined. The variable argument list ap may no longer be used after a call to va_end without a call to va_start.

Example:

#include<stdarg.h> #include<stdio.h> void sum(char *, int, ...); int main(void) { sum("The sum of 10+15+13 is %d./n",3,10,15,13); return 0; } void sum(char *string, int num_args, ...) { int sum=0; va_list ap; int loop; va_start(ap,num_args); for(loop=0;loop<num_args;loop++) sum+=va_arg(ap,int); printf(string,sum); va_end(ap); }
0
0

查看评论
* 以上用户言论只代表其个人观点,不代表CSDN网站的观点或立场
    个人资料
    • 访问:802758次
    • 积分:10870
    • 等级:
    • 排名:第1521名
    • 原创:250篇
    • 转载:101篇
    • 译文:27篇
    • 评论:99条
    最新评论