va_arg

 

C

言語

ヘッダ

型サポート

プログラムユーティリティ

可変長引数サポート

エラー処理

動的メモリ管理

日付と時間のユーティリティ

文字列ライブラリ

アルゴリズム

数値演算

入出力サポート

ローカライゼーションサポート

アトミック操作 (C11)

スレッドサポート (C11)

技術仕様書

 

可変長引数関数

va_start

va_arg

va_copy (C99)

va_end

va_list

 

<tbody> </tbody>

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

va_arg マクロは va_list ap の次の引数に対応する T 型の式に展開されます。

va_arg を呼ぶ前に、 ap は干渉する va_end の呼び出しなしに va_start または va_copy を呼ぶことによって初期化されなければなりません。 va_arg マクロは呼ばれるたびに次の可変長引数を指すよう ap を変更します。

ap の次の引数の (昇格後の) 型が T と互換でない場合、動作は未定義です。 ただし以下の場合は除きます。

• 一方の型が符号付き整数型、他方の型が対応する符号なし整数型で、その値がどちらの型でも表現可能である。 または
• 一方の型が void へのポインタで、他方が文字型へのポインタである。

ap にそれ以上引数がないときに va_arg が呼ばれた場合、動作は未定義です。

引数

ap	-	va_list 型のインスタンス
T	-	ap の次の引数の型

展開後の値

ap の次の可変長引数。

例

Run this code

#include <stdio.h>
#include <stdarg.h>
#include <math.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

参考文献

• C11 standard (ISO/IEC 9899:2011):

• 7.16.1.1 The va_arg macro (p: 269-270)

• C99 standard (ISO/IEC 9899:1999):

• 7.15.1.1 The va_arg macro (p: 249-250)

• C89/C90 standard (ISO/IEC 9899:1990):

• 4.8.1.2 The va_arg macro

関連項目

va_copy (C99)	可変長引数関数の引数をコピーします (関数マクロ)
va_end	可変長引数関数の引数の巡回を終了します (関数マクロ)
va_list	va_start, va_arg, va_end, va_copy で使用される情報を保持します (typedef)
va_start	可変長引数関数の引数にアクセスできるようにします (関数マクロ)
va_arg の C++リファレンス