Namespaces
Variants

va_arg

From cppreference.net
ヘッダーで定義 <stdarg.h>
T va_arg ( va_list ap, T ) ;

va_arg マクロは、 T 型に対応する式に展開され、それは va_list ap からの次のパラメータを表します。

va_arg を呼び出す前に、 ap va_start または va_copy のいずれかで初期化されていなければならず、その間に va_end の呼び出しがあってはなりません。 va_arg マクロを呼び出すたびに、 ap は次の可変引数を指すように変更されます。

次の引数(プロモーション後)の型が ap T 互換性がない 場合、動作は未定義です。ただし以下の場合を除く:

  • 一方の型が符号付き整数型であり、もう一方の型が対応する符号なし整数型であり、値が両方の型で表現可能である場合、または
  • 一方の型が void へのポインタであり、もう一方が文字型へのポインタである場合。

va_arg が呼び出された際に ap にこれ以上引数が存在しない場合、動作は未定義です。

目次

パラメータ

ap - va_list 型のインスタンス
T - ap 内の次のパラメータの型

展開された値

ap 内の次の可変パラメータ

#include <math.h>
#include <stdarg.h>
#include <stdio.h>
double stddev(int count, ...)
{
    double sum = 0;
    double sum_sq = 0;
    va_list args;
    va_start(args, count);
    for (int i = 0; i < count; ++i)
    {
        double num = va_arg(args, double);
        sum += num;
        sum_sq += num*num;
    }
    va_end(args);
    return sqrt(sum_sq / count - (sum / count) * (sum / count));
}
int main(void)
{
    printf("%f\n", stddev(4, 25.0, 27.3, 26.9, 25.7));
}

出力:

0.920258

参考文献

  • C23規格 (ISO/IEC 9899:2024):
  • 7.16.2.2 va_argマクロ (p: TBD)
  • C17規格 (ISO/IEC 9899:2018):
  • 7.16.1.1 va_argマクロ (p: TBD)
  • C11規格 (ISO/IEC 9899:2011):
  • 7.16.1.1 va_argマクロ (p: 269-270)
  • C99規格 (ISO/IEC 9899:1999):
  • 7.15.1.1 va_argマクロ (p: 249-250)
  • C89/C90標準 (ISO/IEC 9899:1990):
  • 4.8.1.2 va_argマクロ

関連項目

(C99)
可変個引数関数の引数のコピーを作成する
(関数マクロ)
可変個引数関数の引数の走査を終了する
(関数マクロ)
va_start , va_arg , va_end , および va_copy によって必要な情報を保持する
(typedef)
可変個引数関数の引数へのアクセスを有効にする
(関数マクロ)