设计变长参数的函数《精通Unix下C语言编程与项目实践》之二 推荐

[align=center]精通Unix下C语言编程与项目实践之二 [/align]
函数的变长参数
[align=center]作者：朱云翔，胡平 [/align]
[align=left]5.4 函数的变长参数 [/align]
[align=center] [/align]
[align=left]文件的格式化输入输出函数都支持变长参数。定义时，变长参数列表通过省略号“…”表示，因此，具有变长参数列表的函数定义格式为：[/align]
[align=left]type 函数名(参数1, 参数2, 参数n, ...);[/align]
[align=left]其中type为函数的返回值类型，参数1～参数n为定长参数，“...”代表变长参数，注意“...”必须定义在参数的最右端。如下例：[/align]
[align=left]int printf(const char *format, ...);[/align]
[align=left]int mysum(...);[/align]

5.4.1. 变长参数的使用

[align=left]Unix的变长参数通过va_list对象实现，定义在文件“stdarg.h”中，变长参数的应用模板如代码5-15所示：[/align]
[align=left]代码5-15 变长参数代码模板[/align]
[align=left]#include <stdarg.h>[/align]
[align=left]function (parmN, ...)[/align]
[align=left]va_list pvar; [/align]
[align=left]……………………………[/align]
[align=left]va_start (pvar, parmN);[/align]
[align=left]while()[/align]
[align=left]{[/align]
[align=left] ……………………[/align]
[align=left] f = va_arg (pvar, type);[/align]
[align=left] ……………………[/align]
[align=left]}[/align]
[align=left]va_end (pvar);[/align]

1. va_list pvar

[align=left]申明va_list数据类型变量pvar，该变量访问变长参数列表中的参数。[/align]

2. va_start(pvar, parmN)

[align=left]宏va_start初始化变长参数列表。pvar是va_list型变量，在步骤1中定义，记载列表中的参数信息。parmN是省略号“...”前的一个参数名，va_start根据此参数，判断参数列表的起始位置，如：[/align]
[align=left]例1. 函数：function(parmN, …)[/align]
[align=left]答：va_start(pvar, parmN);[/align]
[align=left]例2. 函数：int mysum(int i, int j, …)[/align]
[align=left]答：va_start(pvar, j);[/align]

3. va_arg(pvar, type)

[align=left]获取变长参数列表中参数的值。pvar是步骤1中定义的va_list型变量，type为参数值的类型，也是宏va_arg返回数值的类型，如：[/align]
[align=left]va_arg(pvar, int); /* 将参数列表中的当前参数值转化为int型返回 */[/align]
[align=left]va_arg(pvar, float); /* 将参数列表中的当前参数值转化为float型返回*/[/align]
[align=left]宏va_arg执行完毕后自动更改对象pvar，将其指向下一个参数。[/align]

4. va_end(pvar)

[align=left]关闭本次对变长参数列表的访问。[/align]

实例

[align=left]设计函数mysum，计算输入参数的和并返回结果。源程序如代码5-16所示：[/align]
[align=left]代码5-16 变长参数函数实例（节自/code/chapter5/mysum.c）[/b][/align]
[align=left]#include <stdarg.h>[/align]
[align=left]int mysum(int i, ...) /* 参数i表明变长参数的个数 */[/align]
[align=left]{[/align]
[align=left] int r=0, j=0;[/align]
[align=left] va_list pvar;[/align]
[align=left] va_start(pvar, i);[/align]
[align=left] for (j=0; j<i; j++)[/align]
[align=left] {[/align]
[align=left] r += va_arg(pvar, int);[/align]
[align=left] }[/align]
[align=left] va_end(pvar);[/align]
[align=left] return(r);[/align]
[align=left]}[/align]
[align=left]void main()[/align]
[align=left]{[/align]
[align=left] printf("sum(1,4)=%d\n", mysum(1, 4));[/align]
[align=left] printf("sum(2,4,8)=%d\n", mysum(2, 4, 8));[/align]
[align=left]}[/align]
[align=left]编译与运行代码5-16：[/align]
[align=left]# make mysum[/align]
[align=left] cc -O -o mysum mysum.c[/align]
[align=left]# ./mysum[/align]
[align=left]sum(1,4)=4[/align]
[align=left]sum=(2,4,8)=12[/align]

5.4.2 变长参数的传递

[align=left]上一节讲述了如何创建具有变长参数的函数和如何读取变长参数，其操作都在函数内完成，本节将讲述把变长参数列表整体作为参数传递给其他函数的方法。[/align]
[align=left]变长参数传递的函数族如下：[/align]
[align=left]#include <stdarg.h>[/align]
[align=left]int vprintf(const char *format, va_list ap);[/align]
[align=left]int vfprintf(FILE *stream, const char *format, va_list ap);[/align]
[align=left]int vsprintf(char *str, const char *format, va_list ap);[/align]
[align=left]这些函数完全等价于格式化输出函数，只是在形式上采用固定参数代替变长参数，这样描述的函数更加紧凑，这些函数常应用于变长参数函数内部的功能实现。[/align]

实例

[align=left]设计函数“int PrintLog(FILE* stream, const char* pformat, ...)”，它按照字符串format的内容，控制后继参数的数量和格式，并在文件流stream中输出。源程序如代码5-17所示：[/align]
[align=left]代码5-17 传递变长参数实例（节自/code/chapter5/print1.c）[/align]
[align=left]#include <stdarg.h>[/align]
[align=left]#include <stdio.h>[/align]
[align=left]int PrintLog(FILE* pfile, const char * pformat, ...)[/align]
[align=left]{[/align]
[align=left] va_list _va_list;[/align]
[align=left] char szBuf[1024];[/align]
[align=left] if (pformat == NULL || pfile == NULL) return -1; /* 判断指针是否正确*/[/align]
[align=left] va_start(_va_list, pformat); /* 初始化变长参数列表 */[/align]
[align=left] vsprintf(szBuf, pformat, _va_list); /* 传递变长参数 */[/align]
[align=left] va_end(_va_list); /* 结束使用变长参数列表 */[/align]
[align=left] fputs(szBuf, pfile); /* 输出到文件流 */[/align]
[align=left] return 0;[/align]
[align=left]}[/align]
[align=left]void main()[/align]
[align=left]{[/align]
[align=left] PrintLog(stderr, "[%s][%s][%d][%c]\n", "This", "Is", 5, 'a');[/align]
[align=left] PrintLog(stderr, "Error[%p][%.2f][%X]\n", NULL, 3.123, 100);[/align]
[align=left]}[/align]
[align=left]编译与运行代码5-17：[/align]
[align=left]# make print1[/align]
[align=left] cc -O print1.c -o print1[/align]
[align=left]# ./print1 [/align]
[align=left][This][Is][5][a][/align]
[align=left]Error[00000000][3.12][64][/align]
[align=left]【实践经验】对于指针类型的参数，最好在函数入口处判断其是否为空，以免空指针引用错误。如代码5-17中黑体部分。[/align]
[align=left] [/align]

相关文章：
封面 前言 目录 策划 作者
动态库 变长参数 文件锁