fprintf | Programming Place Plus　Ｃ言語編　標準ライブラリのリファレンス

トップページ – Ｃ言語編 – 標準ライブラリのリファレンス（名前順）

トップページ – Ｃ言語編 – 標準ライブラリのリファレンス（ヘッダ別）

fprintf関数

概要

任意のストリームへ、変換指定に沿って変換された文字列を出力する。

ヘッダ

stdio.h

形式

int fprintf(FILE* restrict stream, const char* restrict format, …);

引数

stream

出力先のストリーム。

format

変換指定を含んだ、あるいは含まないプレーンな文字列。

…

format に含まれている変換指定子に対応した個数のパラメータ。

戻り値

正常に終了した場合は、出力した文字数が返される。エラー発生時は負数が返される。

詳細

結果を任意のストリームへ出力することを除き、printf関数と同様であり、同じ機能を持つ。

注意

必要な個数の実引数が指定されていない場合の動作は未定義。余分に指定されている場合には、評価は行われるが、fprintf関数としては無視する。

使用例

 
#include <stdio.h>
#include <stdlib.h>

int main(void)
{
    FILE* fp = fopen("test.txt", "w");
    if (fp == NULL) {
        fputs("ファイルオープンに失敗しました。\n", stderr);
        exit(EXIT_FAILURE);
    }

    if (fprintf(fp, "%d %3d %03d", 10, 10, 10) < 0) {
        fputs("ファイルへの書き込みに失敗しました。\n", stderr);
        exit(EXIT_FAILURE);
    }

    if (fclose(fp) == EOF) {
        fputs("ファイルクローズに失敗しました。\n", stderr);
        exit(EXIT_FAILURE);
    }
}

実行結果 (test.txt)

10  10 010

関連

 標準出力への出力に特化した printf関数がある。変換結果を文字の配列に格納するには sprintf関数を使う。
引数に … ではなく、va_list を使う vfprintf関数がある。
ワイド文字版の fwprintf関数がある。

解説章

第４０章


参考リンク


更新履歴

’2018/4/22　解説中で C95 を（C89 に対して）特別扱いしないように修正。そもそもＣ言語編は C95ベースなので、余計な説明は省く。

’2018/4/8　「戻り値」の内容を修正。

’2018/2/1　Ｃ言語編全体で表記を統一するため、「フォーマット指定」を「変換指定」に改めた。

’2018/1/22　新規作成。


標準ライブラリのリファレンス（名前順）のトップページへ

標準ライブラリのリファレンス（ヘッダ別）のトップページへ

Ｃ言語編のトップページへ

Programming Place Plus のトップページへ

はてなブックマーク に保存 Pocket に保存 Facebook でシェア
Twitter でツイート Twitter をフォロー LINE で送る
rss1.0 取得ボタン RSS 管理者情報 プライバシーポリシー
先頭へ戻る