C ライブラリマクロ -va_end()
va_endマクロは C 標準ライブラリ<stdarg.h>ヘッダファイル内のマクロで、クリーンアップに使用されますva_list変数をクリーンアップし、有効なメモリ位置を指さないようにします。可変引数関数の末尾で使用され、可変引数の処理を終了します。
C ライブラリマクロvoid va_end(va_list ap)使用した...が戻ることを許可しますva_startマクロの付いた可変引数関数が戻ります。関数から戻る前に呼び出されない場合va_end、結果は未定義です。
宣言
以下は va_end() マクロの宣言です。
void va_end(va_list ap);
引数
va_list ap:これはva_list型の変数で、既にva_start或va_copyマクロで初期化され、可変引数リストへのアクセスに使用されます。
戻り値
このマクロは値を返しません。
使用手順
- 可変引数関数では、使用します
va_startマクロで初期化しますva_list変数。 - マクロで各可変引数を順に取得します。
va_argすべての可変引数を処理した後、使用します - マクロでクリーンアップします
va_end変数。va_list例
例
マクロのサンプルプログラムです。このプログラムは、可変数の引数の合計を計算する可変引数関数を定義しています:va_end例
例
#include <stdio.h>
#include <stdarg.h>
// args を初期化して可変引数にアクセスする
int sum(int count, ...) {
int total = 0;
va_list args;
// 各可変引数を取得し、total に加算する
va_start(args, count);
// args をクリーンアップする
for (int i = 0; i < count; i++) {
total += va_arg(args, int);
}
// 6 を出力
va_end(args);
return total;
}
int main() {
printf("Sum of 1, 2, 3: %d\n", sum(3, 1, 2, 3)); // 22 を出力
printf("Sum of 4, 5, 6, 7: %d\n", sum(4, 4, 5, 6, 7)); 上記のプログラムをコンパイルして実行すると、次の結果が得られます:
return 0;
}
#include <stdarg.h>
// args を初期化して可変引数にアクセスする
int sum(int count, ...) {
int total = 0;
va_list args;
// 各可変引数を取得し、total に加算する
va_start(args, count);
// args をクリーンアップする
for (int i = 0; i < count; i++) {
total += va_arg(args, int);
}
// 6 を出力
va_end(args);
return total;
}
int main() {
printf("Sum of 1, 2, 3: %d\n", sum(3, 1, 2, 3)); // 22 を出力
printf("Sum of 4, 5, 6, 7: %d\n", sum(4, 4, 5, 6, 7)); 上記のプログラムをコンパイルして実行すると、次の結果が得られます:
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_endマクロはクリーンアップに使用され va_end変数を、関数が戻る前にリソースを解放し、潜在的なメモリ問題を回避します。va_list呼び出す- 後、
va_end変数は無効になり、再度使用すべきではありません。va_listC 標準ライブラリ - <stdarg.h>
C 標準ライブラリ - <stdarg.h>