va_start

[機能]

　　va_arg，及び，va_end と共に，関数が可変個数を取る場合に，その関数の引数へアクセスする方法を提供するマクロです．関数は，一定の個数の必須引数と，その後に続く可変個数（ 0 を含む）の引数を取ると想定しています．必須引数は，通常の引数として宣言され，変数名を通してアクセスできます．va_start は，可変個数の引数の先頭に arg の値を設定します．最初に va_arg を使用する前に，va_start を必ず使用しなければなりません．

[形式]

#include <stdarg.h>
#include <stdio.h>

void va_start(va_list arg, pre)
	arg : 可変個数の引数リストへのポインタ
	pre : 可変個数の最初の引数に対する名前		

[使用例]

1. 必須引数（この例では整数 1 個で，値は 10 ）と可変個数の引数（タイプは，double ）の平均値を計算します．

   #include <stdio.h>
   #include <stdarg.h>
   
   double average(int, double first, ...);
   
   /************/
   /*     main */
   /************/
   int main()
   {
   	double mean;
   /*
   		 １０と４つの実数値の平均値（負の値がデータの終了記号）
   */
   	mean = average(10, 1.0, 2.0, 3.0, 9.0, -1.0);
   	printf("平均値は %f\n", mean);
   /*
   		 １０と３つの実数値の平均値（負の値がデータの終了記号）
   */
   	mean = average(10, 1.0, 2.0, 3.0, -1.0);
   	printf("平均値は %f\n", mean);
   /*
   		 可変個数の引数がない場合（負の値がデータの終了記号）
   */
   	mean = average(10, -1.0);
   	printf("平均値は %f\n", mean);
   
   	return 0;
   }
   
   /********************/
   /*     平均値の計算 */
   /********************/
   double average(int base, double first, ...)
   {
   	double sum;
   	double d = first;
   	int count = 1;
   	va_list marker;
   
   	sum = (double)base;
   
   	va_start(marker, first);          /* 可変個引数の初期化 */
   
   	while (d >= 0.0) {
   		sum += d;
   		count ++;
   		d = va_arg(marker, double);   /* 次の引数の取得 */
   	}
   
   	va_end(marker);                   /* 可変個引数のreset */
   
   	return (sum / count);
   }
   			

   （出力）

   平均値は 5.000000
   平均値は 4.000000
   平均値は 10.000000			

[参照]

va_arg,　va_end,　vprintf,　vfprintf,　vsprintf