Namespaces
Variants

va_start

From cppreference.net
C
Variadic functions
ヘッダーで定義 <stdarg.h>
void va_start ( va_list ap, parmN ) ;
(C23まで)
void va_start ( va_list ap, ... ) ;
(C23から)

va_start マクロは、可変個引数へのアクセスを可能にします 名前付き引数 parmN に続く (C23まで) 。

va_start は、有効な va_list オブジェクト ap のインスタンスに対して、 va_arg の呼び出しが行われる前に呼び出されなければならない。

parmN が register ストレージクラス指定子、配列型、関数型、またはデフォルト引数プロモーションによって得られる型と互換性のない型で宣言されている場合、動作は未定義です。

(C23まで)

va_start に渡される最初の引数のみが評価されます。追加の引数は展開されず、いかなる方法でも使用されません。

(C23以降)

目次

パラメータ

ap - va_list 型のインスタンス
parmN - 最初の可変引数に先行する名前付きパラメータ

展開された値

(なし)

例

このコードを実行 
#include <stdio.h>
#include <stdarg.h>
int add_nums_C99(int count, ...)
{
    int result = 0;
    va_list args;
    va_start(args, count); // count can be omitted since C23
    for (int i = 0; i < count; ++i) {
        result += va_arg(args, int);
    }
    va_end(args);
    return result;
}
#if __STDC_VERSION__ > 201710L
// Same as above, valid since C23
int add_nums_C23(...)
{
    int result = 0;
    va_list args;
    va_start(args);
    int count = va_arg(args, int);
    for (int i = 0; i < count; ++i) {
        result += va_arg(args, int);
    }
    va_end(args);
    return result;
}
#endif
int main(void)
{
    printf("%d\n", add_nums_C99(4, 25, 25, 50, 50));
#if __STDC_VERSION__ > 201710L
    printf("%d\n", add_nums_C23(4, 25, 25, 50, 50));
#endif
}

出力例: 

150
150

参考文献

  • C17規格 (ISO/IEC 9899:2018):
  • 7.16.1.4 va_startマクロ (p: 198-199)
  • C11規格 (ISO/IEC 9899:2011):
  • 7.16.1.4 va_startマクロ (p: 271-272)
  • C99規格 (ISO/IEC 9899:1999):
  • 7.15.1.4 va_startマクロ (p: 251-252)
  • C89/C90標準 (ISO/IEC 9899:1990):
  • 4.8.1.1 va_startマクロ

関連項目

次の可変個引数関数の引数にアクセスする
(関数マクロ)
(C99)
可変個引数関数の引数のコピーを作成する
(関数マクロ)
可変個引数関数の引数の走査を終了する
(関数マクロ)
va_start , va_arg , va_end , および va_copy が必要とする情報を保持する
(typedef)
C++ documentation for va_start