vprintf

可変長引数リストのデータを書式文字列に従って標準出力 (standard output) に出力します． 

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

int vprintf(
    const char * restrict format,
    va_list arg
);

vprintf 関数は可変長引数リスト arg のデータを format が指す書式文字列に従って標準出力へ書き込みを行います．

vprintf の呼び出し前には va_start マクロで引数 arg を初期化しておく必要があります．また，vfprintf は va_end マクロを呼び出しません．したがってユーザーが手動で va_end を呼び出す必要があります．

vprintf の動作は可変長引数 (variable arguments) を arg に置き換えた printf と同じです．

引数

  • format: 書式文字列 (詳しくは printf の書式文字列を参照してください)
  • arg: 変換するパラメータのリスト (可変長引数リスト)

戻り値

  • 成功した場合: 書き出された文字数
  • 失敗した場合: 負の値

C言語サンプルプログラム

vprintf 関数を使用して可変長引数リストのデータを標準出力に出力するサンプルプログラムを以下に示します．

/* header files */
#include <stdio.h>
#include <stdlib.h>
#include <stdarg.h>

/* functions */
int DisplayAverage(const char *format, ...);

/* main */
int main(void) {
    int i;
    int points1[] = {100, 300, 200};
    int points2[] = {5, 30, 20, 25};

    int sum;
    double avg1, avg2;

    /* 平均1を求める */
    sum = points1[0];
    for ( i = 1; i < 3; i++ ) {
        sum += points1[i];
    }
    avg1 = (int)sum / 3.0;

    /* 平均1の表示 */
    DisplayAverage("{%d, %d, %d} Average1 = %.2f\n", 
            points1[0], points1[1], points1[2], avg1);

    /* 平均2を求める */
    sum = points2[0];
    for ( i = 1; i < 4; i++ ) {
        sum += points2[i];
    }
    avg2 = (int)sum / 4.0;

    /* 平均2の表示 */
    DisplayAverage("{%d, %d, %d, %d} Average2 = %.2f\n", 
            points2[0], points2[2], points2[3], points2[4], avg2);

    return EXIT_SUCCESS;
}

/**
 * @brief 平均を表示する
 * @param[IN] format 書式文字列
 * @param[IN] ... 可変長引数
 * @return EXIT_SUCCESS
 */
int DisplayAverage(const char *format, ...) {
    va_list arg;

    va_start(arg, format);
    vprintf(format, arg);
    va_end(arg);

    return EXIT_SUCCESS;
}

実行例

サンプルプログラムの実行結果は以下のようになります．

{100, 300, 200} Average1 = 200.00
{5, 20, 25, 100} Average2 = 20.00

cプログラマの必読書

たくさんあるc言語関連の書籍の中でも特に役に立った本です．よかったら参考にしてみてください．

c実践プログラミング 第3版

c言語の実践的参考書．少々値段は張りますが初心者を脱しようとしている人は絶対に読むべきです．
文法だけでなく，コーディングスタイルやデバッグなど文字通り「実践的」なことが書かれているので非常にためになります． オライリーの本は，読みにくい本が多いのですが本書はとても読みやすくオススメです．


c言語ポインタ完全制覇 (標準プログラマーズライブラリ)

ポインタの解説書としては最高の書籍です．
この1冊でポインタを完全に理解することができます．全くの初学者が読むには敷居が高いですが，入門書を読み終えた後に読むと非常に有益です．