C ライブラリ関数 -vfprintf()

C 標準ライブラリ - <stdio.h>

説明

C ライブラリ関数int vfprintf(FILE *stream, const char *format, va_list arg)可変引数リストを使用して、フォーマットされた出力をストリーム(stream)に送信します。

宣言

以下が vfprintf() 関数の宣言です。

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

パラメータ

  • stream-- これは FILE オブジェクトへのポインタであり、その FILE オブジェクトがストリームを識別します。
  • format-- これは C 文字列であり、ストリームに書き込まれるテキストを含みます。埋め込みの format タグを含むことができ、format タグは後続の追加パラメータで指定される値で置き換えられ、必要に応じてフォーマットされます。format タグの属性は次のとおりです。 %[flags][width][.precision][length]specifier、具体的には以下のとおりです。
specifier(指定子)出力
c文字
d または i符号付き10進整数
ee 文字を使用した科学的記数法(仮数と指数)
EE 文字を使用した科学的記数法(仮数と指数)
f10進浮動小数点数
g%e または %f の適切な表現を自動選択
G%E または %f の適切な表現を自動選択
o符号付き8進数
s文字列
u符号なし10進整数
x符号なし16進整数
X符号なし16進整数(大文字)
pポインタアドレス
n出力なし
%文字

flags(フラグ)説明
-指定されたフィールド幅内で左揃えにします。デフォルトは右揃えです(width サブ指定子を参照)。
+結果の前にプラス記号またはマイナス記号(+ または -)を強制的に表示します。つまり、正数の前には + 記号が表示されます。デフォルトでは、負数の前だけに - 記号が表示されます。
(space)記号が何も書き込まれない場合、その値の前にスペースが挿入されます。
#o、x、X 指定子と一緒に使用すると、非ゼロ値の前にそれぞれ 0、0x、または 0X が表示されます。
e、E、f と一緒に使用すると、小数点を含む出力が強制され、後ろに数字がなくても小数点が表示されます。デフォルトでは、後ろに数字がない場合、小数点は表示されません。
g または G と一緒に使用すると、結果は e または E を使用した場合と同じですが、末尾のゼロは削除されません。
0指定されたパディング(padding)の数値の左側に、スペースの代わりにゼロ(0)を配置します(width サブ指定子を参照)。

width(幅)説明
(number)出力する文字の最小数。出力される値がその数より短い場合、結果はスペースで埋められます。出力される値がその数より長い場合、結果は切り詰められません。
*幅が format 文字列で指定されていない場合、フォーマットされるパラメータの前に追加の整数値パラメータとして配置されます。

.precision(精度)説明
.number整数指定子(d、i、o、u、x、X)の場合:precision は書き込む数字の最小桁数を指定します。書き込まれる値がその数より短い場合、結果は先頭ゼロで埋められます。書き込まれる値がその数より長い場合、結果は切り詰められません。精度が 0 の場合、文字は書き込まれないことを意味します。
e、E、f 指定子の場合:小数点の後に出力する小数桁数。
g および G 指定子の場合:出力する最大有効桁数。
s の場合:出力する最大文字数。デフォルトでは、末尾のヌル文字に遭遇するまで、すべての文字が出力されます。
c タイプの場合:影響はありません。
精度が何も指定されていない場合、デフォルトは 1 です。明示的な値を伴わずに指定された場合は、0 と見なされます。
.*精度が format 文字列で指定されていない場合、フォーマットされるパラメータの前に追加の整数値パラメータとして配置されます。

length(長さ)説明
hパラメータは short 整数型または unsigned short 整数型として解釈されます(整数指定子:i、d、o、u、x、X にのみ適用)。
lパラメータは long 整数型または unsigned long 整数型として解釈され、整数指定子(i、d、o、u、x、X)および指定子 c(ワイド文字を表す)と s(ワイド文字列を表す)に適用されます。
Lパラメータは long double 型として解釈されます(浮動小数点指定子:e、E、f、g、G にのみ適用)。
  • arg-- 可変引数リストを表すオブジェクト。これは <stdarg> で定義された va_start マクロで初期化される必要があります。

戻り値

成功した場合は、書き込まれた文字の総数を返し、それ以外の場合は負の数を返します。

例

以下の例は、vfprintf() 関数の使用方法を示しています。

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

void WriteFrmtd(FILE *stream, char *format, ...)
{
   va_list args;

   va_start(args, format);
   vfprintf(stream, format, args);
   va_end(args);
}

int main ()
{
   FILE *fp;

   fp = fopen("file.txt","w");

   WriteFrmtd(fp, "This is just one argument %d \n", 10);

   fclose(fp);
   
   return(0);
}

上記のプログラムをコンパイルして実行すると、現在のディレクトリにあるファイルが開かれます。file.txt、以下の内容が書き込まれます。

This is just one argument 10

次に、以下のプログラムを使用して、上記のファイルの内容を確認しましょう。

#include <stdio.h>

int main ()
{
   FILE *fp;
   int c;

   fp = fopen("file.txt","r");
   while(1)
   {
      c = fgetc(fp);
      if( feof(fp) )
      {
          break ;
      }
      printf("%c", c);
   }
   fclose(fp);
   return(0);
}

C 標準ライブラリ - <stdio.h>

その他の拡張