C ライブラリマクロ -va_arg()
va_argマクロは C 標準ライブラリ<stdarg.h>ヘッダーファイル内のマクロで、可変引数関数内で各可変引数の値を順番に取得するために使用されます。これはva_start[va_start] マクロで初期化したva_list[ap] 変数の後に、可変引数リスト内の次の引数にアクセスするために使用されます。
宣言
以下は va_arg() マクロの宣言です。
type va_arg(va_list ap, type);
引数
va_list ap:1つのva_list[va_list] 型の変数で、これはすでにva_start[va_start] マクロによって初期化され、現在の可変引数リストの位置を指します。type:取得する次の引数の型。明確に識別できる型でなければなりません。
戻り値
現在の可変引数リスト内の次の引数を、type 型で返します。
使用手順
- 可変引数関数内で、[va_start] マクロを使用して
va_start初期化しますva_list[ap] 変数。 - [va_arg] マクロを使用して
va_arg各可変引数を順番に取得します。 - [va_end] マクロを使用して
va_endクリーンアップしますva_list[ap] 変数。
例
以下は、[va_arg] マクロを使用したva_argサンプルプログラムです。このプログラムは、可変数の引数の合計を計算する可変引数関数を定義しています:
例
#include <stdio.h>
#include <stdarg.h>
// 可変引数関数、引数の合計を計算する
int sum(int count, ...) {
int total = 0;
va_list args;
// 可変引数にアクセスするために args を初期化
va_start(args, count);
// 可変引数を1つずつ取得し、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;
}
#include <stdarg.h>
// 可変引数関数、引数の合計を計算する
int sum(int count, ...) {
int total = 0;
va_list args;
// 可変引数にアクセスするために args を初期化
va_start(args, count);
// 可変引数を1つずつ取得し、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;:1つのva_list[va_list] 型の変数を宣言し、args可変引数リストの情報を格納するために使用されます。va_start(args, count);:初期化しargs[last] の後から始まる可変引数にアクセスできるようにcountします。total += va_arg(args, int);:[va_arg] マクロを使用してva_arg次の可変引数を取得します。ここではそれらがすべてint[int] 型であると仮定し、それをtotal[sum] 変数に累積します。va_end(args);:[ap] をクリーンアップします。argsリソースを解放し、未定義動作を避けるためです。
注意事項
va_arg[va_arg] マクロはva_start[va_start] の後に使用し、[va_end]va_endの前に使用します。type引数は明確な型でなければならず、可変引数の実際の型と一致する必要があります。- [va_arg] を呼び出した
va_argときに可変引数の数を超えた場合、動作は未定義です。 - [va_end] を使用して
va_end[ap] 変数をクリーンアップすることはva_list必須です。潜在的なリソースリークや未定義動作を避けるためです。
C 標準ライブラリ - <stdarg.h>