va_copy

 

C

コンパイラサポート

言語

ヘッダー

型サポート

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

可変長引数関数のサポート

エラーハンドリング

動的メモリ管理

文字列ライブラリ

アルゴリズム

数値

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

入出力サポート

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

並行処理サポート (C11)

技術仕様

シンボルインデックス

 

可変引数関数

va_start

va_arg

va_copy (C99)

va_end

va_list

 

ヘッダー <stdarg.h> で定義
void va_copy( va_list dest, va_list src );		(C99以降)

va_copy マクロは、src を dest にコピーします。

関数が戻る前、または dest の後続の再初期化（va_start または va_copy への呼び出しによる）の前には、dest に対して va_end を呼び出す必要があります。

パラメータ

dest	-	初期化される va_list 型のインスタンス
src	-	dest を初期化するために使用されるソース va_list

展開された値

(なし)

例

このコードを実行

#include <stdio.h>
#include <stdarg.h>
#include <math.h>
 
double sample_stddev(int count, ...) 
{
    /* Compute the mean with args1. */
    double sum = 0;
    va_list args1;
    va_start(args1, count);
    va_list args2;
    va_copy(args2, args1);   /* copy va_list object */
    for (int i = 0; i < count; ++i) {
        double num = va_arg(args1, double);
        sum += num;
    }
    va_end(args1);
    double mean = sum / count;
 
    /* Compute standard deviation with args2 and mean. */
    double sum_sq_diff = 0;
    for (int i = 0; i < count; ++i) {
        double num = va_arg(args2, double);
        sum_sq_diff += (num-mean) * (num-mean);
    }
    va_end(args2);
    return sqrt(sum_sq_diff / count);
}
 
int main(void) 
{
    printf("%f\n", sample_stddev(4, 25.0, 27.3, 26.9, 25.7));
}

実行結果の例

0.920258

参照

• C11標準 (ISO/IEC 9899:2011)

• 7.16.1.2 va_copy マクロ (p: 270)

• C99標準 (ISO/IEC 9899:1999)

• 7.15.1.2 va_copy マクロ (p: 250)

関連項目

va_arg	次の可変長引数にアクセスする (関数マクロ)
va_end	可変長引数の走査を終了する (関数マクロ)
va_list	va_start、va_arg、va_end、va_copy で必要とされる情報を保持する (typedef)
va_start	可変長引数関数へのアクセスを有効にする (関数マクロ)
C++ ドキュメント（va_copy について）