Cライブラリ関数 -fprintf()
説明
Cライブラリ関数int fprintf(FILE *stream, const char *format, ...)フォーマットされた出力をストリーム stream に送信します。
宣言
以下は fprintf() 関数の宣言です。
int fprintf(FILE *stream, const char *format, ...)
引数
- stream-- これは FILE オブジェクトを指すポインタで、その FILE オブジェクトがストリームを識別します。
- format-- これは C 文字列で、ストリーム stream に書き込まれるテキストを含みます。埋め込みの format タグを含むことができ、format タグは後続の追加引数で指定された値に置き換えられ、必要に応じてフォーマットされます。format タグの属性は %[flags][width][.precision][length]specifier、具体的な解説は次のとおりです。
| specifier(指定子) | 出力 |
|---|---|
| c | 文字 |
| d または i | 符号付き10進整数 |
| e | e 文字を使用した科学的記数法(仮数と指数) |
| E | E 文字を使用した科学的記数法(仮数と指数) |
| f | 10進浮動小数点数 |
| 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 int 型または unsigned short int 型として解釈されます(整数指定子: i、d、o、u、x、X にのみ適用)。 |
| l | 引数は long int 型または unsigned long int 型として解釈され、整数指定子(i、d、o、u、x、X)および指定子 c(ワイド文字を表す)と s(ワイド文字列を表す)に適用されます。 |
| L | 引数は long double 型として解釈されます(浮動小数点指定子: e、E、f、g、G にのみ適用)。 |
- 追加引数-- さまざまな format 文字列に応じて、関数は一連の追加引数を必要とする場合があります。各引数には、format 引数で指定された各 % タグを置き換えるために挿入される値が含まれます。引数の数は % タグの数と同じである必要があります。
戻り値
成功した場合は書き込まれた文字の総数を返し、それ以外の場合は負の数を返します。
実例
以下の実例は fprintf() 関数の使い方を示しています。
実例
#include <stdio.h>
#include <stdlib.h>
int main()
{
FILE * fp;
fp = fopen ("file.txt", "w+");
fprintf(fp, "%s %s %s %d", "We", "are", "in", 2014);
fclose(fp);
return(0);
}
#include <stdlib.h>
int main()
{
FILE * fp;
fp = fopen ("file.txt", "w+");
fprintf(fp, "%s %s %s %d", "We", "are", "in", 2014);
fclose(fp);
return(0);
}
上記のプログラムをコンパイルして実行してみましょう。これによりファイルが作成されますfile.txt、その内容は次のとおりです。
We are in 2014
次に、以下のプログラムを使用して上記のファイルの内容を確認してみましょう。
実例
#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);
}
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);
}