C语言中可变参函数介绍与示例

「爱情、让人受尽委屈。」 2022-05-25 03:56 278阅读 0赞

本文主要介绍C语言中可变参函数的相关内容，以及展示几个简单的可变参函数功能的示例。

## 1. 可变参函数的概念 ##

在使用C语言编程的时候，函数中形式参数的数目通常是确定的，在调用时要依次给出与形式参数对应的所有实际参数，但在某些情况下，我们希望函数的参数个数可以根据需要来确定（例如常见的printf()函数，它的函数参数个数就是不确定的），这时我们就需要可变参函数了。

采用 ANSI 标准形式时，可变参函数的原型声明如下：

type funcname(type para1, type para2, ...)

上述函数定义形式至少需要一个普通的形式参数，后面的省略是函数原型的一部分，表示该函数为可变参函数，type是函数返回值和形参的类型。

**注意：**函数参数表中的三个圆点只能放在参数表最后，即在所有普通参数之后。

## 2. 用法 ##

为了能在可变参函数里取得并处理不定个数的“其他参数”，需要使用头文件<stdarg.h>提供的一套机制。

头文件<stdarg.h>提供了一个特殊类型va\_list，在每个可变参函数的函数体里必须定义一个va\_list类型的局部变量，它将成为访问由三个圆点所代表的实际参数的媒介。

下面假设某个可变参函数里所用的va\_list类型的变量的名字是vap，我们使用vap访问实参的步骤大致如下：

1）在使用vap访问实际参数之前，必须先用宏va\_start对这个变量初始化，如下：

va_start(vap, nNum);

nNum是可变参函数的最后一个确定的参数，va\_start使vap指向第一个可选参数。

2）然后使用va\_arg宏返回参数列表中的当前参数，并使vap指向参数列表中的下一个参数，如下：

va_arg(vap, int);

在调用宏va\_arg时必须提供有关实参的实际类型（如本例中的int），这一类型也将成为这个宏调用的返回值类型。

3）在使用va\_arg宏获取了所有的实参之后，最后使用va\_end宏把vap指针清为NULL，如下：

va_end(vap);

我们在函数体内可以多次遍历这些由vap代表的实参，但是都必须以va\_start开始，并以va\_end结尾。

## 3. demo演示 ##

3.1 demo1

需求：我们想定义一个函数sum，该函数可以有任意多个整型参数，函数sum最终返回这些参数的和。

我们应该将sum函数定义为一个只有一个普通参数、并具有可变长度参数表的函数，这个函数的头部应该是（函数原型与此类似）：

int sum(int n, ...)

实际上我们要求在调用该函数时，第一个参数n代表想要求和的参数个数，而其余的参数为将要进行求和的参数。

完整代码（variable\_arg.c）如下：

#include <stdio.h>
    #include <stdarg.h>
    
    int sum(int nNum, ...)
    {
        va_list vap;
        int nSum = 0;
        int i;
    
        va_start(vap, nNum);
        for (i = 0; i < nNum; i++)
        {
            nSum += va_arg(vap, int);
        }
        va_end(vap);
    
        return nSum;
    }
    
    int main()
    {
        int nSumValue = 0;
    
        nSumValue = sum(3, 10, 11, 19);
    
        printf("nSumValue is: %d\n", nSumValue);
    
        return 0;
    }

编译后，运行该程序，运行结果如下：

![70][]

上述结果显示可变参函数sum满足了我们的需求。

3.2 demo2

需求：使用可变参函数，将可变个数的字符串参数打印出来。

我们应该将demo函数定义为一个只有一个普通参数、并具有可变长度参数表的函数，这个函数的头部应该是（函数原型与此类似）：

int demo(char* msg, ...)

我们在调用该函数时，会将除msg外的其余的参数打印出来，同时需要注意，**在实际调用这个函数时，要通过一定的方法指明实际参数的个数，例如把最后一个参数置为空字符串（本例采用此种方式）或其他的方式。**

完整代码（variable\_arg2.c）如下：

#include <stdio.h>
    #include <string.h>
    #include <stdarg.h>
    
    /* 函数原型声明，至少需要一个确定的参数，注意括号内的省略号*/
    int demo(char*, ...);
    
    int main()
    {
        demo("DEMO", "This", "is", "a", "demo!", "");
    }
    
    /* ANSI标准形式的声明方式，括号内的省略号表示可选参数 */
    int demo(char *msg, ...)
    {
        /* 定义保存函数参数的结构 */
        va_list argp;
    
        /* 记录参数个数 */
        int argno = 0; 
        /* 存放取出的字符串参数*/
        char *para;
    
        /* argp指向传入的第一个可选参数，msg是最后一个确定的参数 */
        va_start(argp, msg);
    
        while (1)
        {
            /* 取出当前的参数，类型为char* */
            para = va_arg(argp, char*);
            /* 采用空串指示参数输入结束 */
            if (strcmp("", para) == 0)
            {
                break;
            }
            
            printf("Parameter #%d is: %s\n", argno, para);
            argno++;
        }
        
        /* 将argp置为NULL */
        va_end(argp); 
        
        return 0;
    }

编译后，运行该程序，运行结果如下：

![70 1][]

上述结果显示可变参函数demo满足了我们的需求。

[70]: /images/20220525/0882061e050f4f0fb44baa8fe4dff098.png
[70 1]: /images/20220525/06bc357e0f9e451f8810bae163688570.png