va_copy

 

C

言語

ヘッダ

型サポート

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

可変長引数サポート

エラー処理

動的メモリ管理

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

文字列ライブラリ

アルゴリズム

数値演算

入出力サポート

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

アトミック操作 (C11)

スレッドサポート (C11)

技術仕様書

 

可変長引数関数

va_start

va_arg

va_copy (C99)

va_end

va_list

 

<tbody> </tbody>

ヘッダ <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

展開後の値

(なし)

例

Run this code

#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 standard (ISO/IEC 9899:2011):

• 7.16.1.2 The va_copy macro (p: 270)

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

• 7.15.1.2 The va_copy macro (p: 250)

関連項目

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