vfprintf

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

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

int vfprintf(
    FILE * restrict stream,
    const char * restrict format,
    va_list arg
);

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

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

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

引数

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

戻り値

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

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

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

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

/* functions */
void inputError(char *function, char *format, ...);

/* main */
int main(void) {
    int sex, age;

    /* 性別の入力 */
    puts("性別を入力してください。(1:男性 2:女性)");
    scanf("%d", &sex);
    if ( sex != 1 && sex != 2 ) {
        inputError("main", "性別は1か2で入力してください. (入力値: %d)\n", sex);
        return EXIT_FAILURE;
    }

    /* 年齢の入力 */
    puts("年齢を入力してください.");
    scanf("%d", &age);
    if ( age < 0 || age > 150 ) {
        inputError("main", "嘘はいけません.(入力値: %d)\n", age);
        return EXIT_FAILURE;
    }

    puts("分かりました.");

    return EXIT_SUCCESS;
}

/**
 * @brief エラー処理を行う
 * @param[IN] function 関数名
 * @param[IN] format 書式文字列
 * @param[IN] ... 可変長引数
 */
void inputError(char *function, char *format, ...) {
    va_list arg;
    va_start(arg, format);

    /* エラーが発生した関数名を表示 */
    fprintf(stderr, "エラーが発生した関数: %s\n", function);

    /* エラーメッセージを表示 */
    vfprintf(stderr, format, arg);

    va_end(arg);
}

実行例

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

性別を入力してください. (1:男性 2:女性)
(3 を入力)

エラーが発生した関数: main
性別は1か2で入力してください. (入力値: 3)

性別を入力してください. (1:男性 2:女性)
(1 を入力)
年齢を入力してください.
(-1 を入力)

エラーが発生した関数: main
嘘はいけません. (入力値: -1)

cプログラマの必読書

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

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

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


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

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