C标准库--stdarg.h

C 标准库 - <stdarg.h>

简介

stdarg.h 头文件定义了一个变量类型 va_list 和三个宏，这三个宏可用于在参数个数未知（即参数个数可变）时获取函数中的参数.可变参数的函数通在参数列表的末尾是使用省略号(,…)定义的。

库变量

下面是头文件 stdarg.h 中定义的变量类型：

1 va_list

这是一个适用于 va_start()、va_arg() 和 va_end() 这三个宏存储信息的类型。

库函数

1 void va_start(va_list ap, last_arg)

这个宏初始化 ap 变量，它与 va_arg 和 va_end 宏是一起使用的。last_arg 是最后一个传递给函数的已知的固定参数，即省略号之前的参数。

这个宏必须在使用 va_arg 和 va_end 之前被调用。

声明: 下面是 va_start() 宏的声明。

void va_start(va_list ap, last_arg);

参数
ap – 这是一个 va_list 类型的对象，它用来存储通过 va_arg 获取额外参数时所必需的信息。
last_arg – 最后一个传递给函数的已知的固定参数。
返回值
NA
实例
下面的实例演示了 va_start() 宏的用法。

#include<stdarg.h>
#include<stdio.h>

int sum(int, ...);

int main(void)
{
   printf("10、20 和 30 的和 = %d\n",  sum(3, 10, 20, 30) );
   printf("4、20、25 和 30 的和 = %d\n",  sum(4, 4, 20, 25, 30) );
   return 0;
}

int sum(int num_args, ...)
{
   int val = 0;
   va_list ap;
   int i;
   va_start(ap, num_args);
   for(i = 0; i < num_args; i++)
   {
      val += va_arg(ap, int);
   }
   va_end(ap);
   return val;
}

让我们编译并运行上面的程序，这将产生以下结果：

10、20 和 30 的和 = 60
4、20、25 和 30 的和 = 79

2 type va_arg(va_list ap, type)

这个宏检索函数参数列表中类型为 type 的下一个参数。

描述
C 库宏 type va_arg(va_list ap, type) 检索函数参数列表中类型为 type 的下一个参数。它无法判断检索到的参数是否是传给函数的最后一个参数。

声明
下面是 va_arg() 宏的声明。

type va_arg(va_list ap, type)
参数
ap – 这是一个 va_list 类型的对象，存储了有关额外参数和检索状态的信息。该对象应在第一次调用 va_arg 之前通过调用 va_start 进行初始化。
type – 这是一个类型名称。该类型名称是作为扩展自该宏的表达式的类型来使用的。
返回值
该宏返回下一个额外的参数，是一个类型为 type 的表达式。

实例
下面的实例演示了 va_arg() 宏的用法。

#include <stdarg.h>
#include <stdio.h>

int sum(int, ...);

int main()
{
   printf("15 和 56 的和 = %d\n",  sum(2, 15, 56) );
   return 0;
}

int sum(int num_args, ...)
{
   int val = 0;
   va_list ap;
   int i;

   va_start(ap, num_args);
   for(i = 0; i < num_args; i++) 
   {
      val += va_arg(ap, int);
   }
   va_end(ap);
 
   return val;
}

让我们编译并运行上面的程序，这将产生以下结果：

15 和 56 的和 = 71

3 void va_end(va_list ap)

这个宏允许使用了 va_start 宏的带有可变参数的函数返回。如果在从函数返回之前没有调用 va_end，则结果为未定义。
描述
C 库宏 void va_end(va_list ap) 允许使用了 va_start 宏的带有可变参数的函数返回。如果在从函数返回之前没有调用 va_end，则结果为未定义。

声明
下面是 va_end() 宏的声明。

void va_end(va_list ap)
参数
ap – 这是之前由同一函数中的 va_start 初始化的 va_list 对象。
返回值
该宏不返回任何值。

实例
下面的实例演示了 va_end() 宏的用法。

#include <stdarg.h>
#include <stdio.h>

int mul(int, ...);

int main()
{
   printf("15 * 12 = %d\n",  mul(2, 15, 12) );
   
   return 0;
}

int mul(int num_args, ...)
{
   int val = 1;
   va_list ap;
   int i;

   va_start(ap, num_args);
   for(i = 0; i < num_args; i++) 
   {
      val *= va_arg(ap, int);
   }
   va_end(ap);
 
   return val;
}

让我们编译并运行上面的程序，这将产生以下结果：

15 * 12 =  180

变参使用实例 test.c：

#include <stdio.h>
#include <string.h>
#include <stdarg.h>

void tLog(char *sInfo, ...);

int main(int argc, char *argv[])
{
    char str[4+1] = {0};
    strcpy(str,"INFO");
    tLog(str,argv[1],argv[2],argv[3]);
    return 0;
}
void tLog(char *sInfo, ...)
{
    char *str   = NULL;
    char *str1 = NULL;
    char *str2 = NULL;
    va_list sArgv;          // 申请参数列表变量
    va_start(sArgv, sInfo); // 申明最后一个传递给函数的已知的固定参数
    /* 依次读取固定参数 sInfo 后的 参数 */
    str   = va_arg(sArgv, char*);
    str1 = va_arg(sArgv, char*);
    str2 = va_arg(sArgv, char*);
    va_end(sArgv);
    printf("运行输出：[%s,%s%s%s]\n",sInfo,str,str1,str2);
}

编译 gcc test.c 得到 a.out。
运行程序：

$ ./a.out  Runoob Google Facebook
运行输出：[INFO,RunoobGoogleFacebook]