C ライブラリマクロ -va_start()
説明
va_startマクロはC標準ライブラリの<stdarg.h>ヘッダーファイル内のマクロであり、ある変数を初期化するために使用されます。va_list変数。可変引数関数内で可変個の引数にアクセスするために使用されます。
C ライブラリマクロ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);
引数
va_list ap:これは可変引数にアクセスするための型です。マクロ呼び出し後に初期化され、後続のva_arg呼び出しで引数を取得するために使用されます。last:これは可変引数リストの前の最後の既知の固定引数です。つまり、関数の引数リスト内の、可変引数が始まる前の最後の引数です。
戻り値
NA
使用手順
- 可変引数関数を定義します。少なくとも1つの固定引数(つまり
last引数)が必要です。 - 次のものを宣言します:
va_list変数(可変引数リストの情報を格納するための変数)。 - 使用します
va_startマクロで初期化しますva_list変数。 - 使用します
va_argマクロで各可変引数を順に取得します。 - 使用します
va_endマクロでクリーンアップしますva_list変数。
例
以下の例は va_start() マクロの使い方を示しています。
例
#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;
}
#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_start必ずva_list、va_argとva_end一緒に使用する必要があります。- 呼び出し
va_start後、必ず呼び出さなければなりませんva_end可変引数の処理を終了するために。 - 呼び出す
va_start前に、関数の引数リストに少なくとも1つの固定引数があることを確認する必要があります。 last引数は可変引数リストの前の最後の固定引数であり、可変引数の処理をどこから開始するかを決定するために使用されます。
C 標準ライブラリ - <stdarg.h>