C 库宏 - va_arg()

C 标准库 - <stdarg.h> C 标准库 - <stdarg.h>

va_arg 宏是 C 标准库 <stdarg.h> 头文件中的一个宏，用于在可变参数函数中依次获取每个可变参数的值。它在使用 va_start 宏初始化了 va_list 变量之后，用于访问可变参数列表中的下一个参数。

声明

下面是 va_arg() 宏的声明。

type va_arg(va_list ap, type);

参数

  • va_list ap：一个 va_list 类型的变量，它已经通过 va_start 宏初始化，指向当前可变参数列表的位置。
  • type：要获取的下一个参数的类型。必须是一个可以明确识别的类型。

返回值

返回当前可变参数列表中的下一个参数，类型为 type。

使用步骤

  • 在可变参数函数中，使用 va_start 宏初始化 va_list 变量。
  • 使用 va_arg 宏依次获取每个可变参数。
  • 使用 va_end 宏清理 va_list 变量。

实例

以下是一个使用 va_arg 宏的示例程序，该程序定义了一个可变参数函数来计算可变数量参数的总和：

实例

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

// 可变参数函数，计算参数的总和
int sum(int count, ...) {
    int total = 0;
    va_list args;

    // 初始化 args 以访问可变参数
    va_start(args, count);

    // 逐个获取可变参数，并累加到 total
    for (int i = 0; i < count; i++) {
        total += va_arg(args, int);
    }

    // 清理 args
    va_end(args);

    return total;
}

int main() {
    printf("Sum of 1, 2, 3: %d\n", sum(3, 1, 2, 3));  // 输出 6
    printf("Sum of 4, 5, 6, 7: %d\n", sum(4, 4, 5, 6, 7));  // 输出 22
    return 0;
}

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

Sum of 1, 2, 3: 6
Sum of 4, 5, 6, 7: 22

解析

  • va_list args;：声明一个 va_list 类型的变量 args，用于存储可变参数列表的信息。
  • va_start(args, count);：初始化 args 以便访问从 count 之后开始的可变参数。
  • total += va_arg(args, int);：使用 va_arg 宏获取下一个可变参数，这里假设它们都是 int 类型，并将其累加到 total 变量中。
  • va_end(args);：清理 args，以便释放资源并避免未定义行为。

注意事项

  • va_arg 宏应在 va_start 之后使用，并在 va_end 之前使用。
  • type 参数必须是一个明确的类型，并且应与可变参数的实际类型匹配。
  • 如果在调用 va_arg 时超出了可变参数的数量，行为是未定义的。
  • 使用 va_end 清理 va_list 变量是必须的，以避免潜在的资源泄漏或未定义行为。

C 标准库 - <stdarg.h> C 标准库 - <stdarg.h>