C ライブラリ関数 -fscanf()
説明
C ライブラリ関数int fscanf(FILE *stream, const char *format, ...)ストリーム stream からフォーマットされた入力を読み取ります。
宣言
以下は fscanf() 関数の宣言です。
int fscanf(FILE *stream, const char *format, ...)
引数
- stream-- これは FILE オブジェクトへのポインタであり、この FILE オブジェクトがストリームを識別します。
- format-- これは C 文字列であり、以下の項目の1つ以上を含みます:空白文字、非空白文字とformat 指定子。
format 指定子の形式は次のとおりです。[=%[*][width][modifiers]type=]、具体的な解説は以下の通りです。
| 引数 | 説明 |
|---|---|
| * | これはオプションのアスタリスクで、データがストリーム stream から読み取られるが無視できることを示します。つまり、対応する引数に格納されません。 |
| width | これは、現在の読み取り操作で読み取る最大文字数を指定します。 |
| modifiers | 対応する追加引数が指すデータに対して、整数型(d、i、n の場合)、符号なし整数型(o、u、x の場合)、または浮動小数点型(e、f、g の場合)とは異なるサイズを指定します: h :短整数型(d、i、n の場合)、または符号なし短整数型(o、u、x の場合) l :長整数型(d、i、n の場合)、または符号なし長整数型(o、u、x の場合)、または double 型(e、f、g の場合) L :long double 型(e、f、g の場合) |
| type | 1つの文字で、読み取るデータ型とデータの読み取り方法を指定します。詳細は次の表を参照してください。 |
fscanf 型指定子:
| 型 | 適合する入力 | 引数の型 |
|---|---|---|
| c | 単一文字:次の文字を読み取ります。1 以外の幅 width が指定された場合、関数は width 個の文字を読み取り、パラメータを介してそれらを配列の連続する位置に格納します。末尾にヌル文字は追加されません。 | char * |
| d | 10進整数:数値の前の + または - 記号はオプションです。 | int * |
| e,E,f,g,G | 浮動小数点数:小数点、オプションの前置符号 + または -、オプションの後置文字 e または E、および10進数字を含みます。有効な例として -732.103 と 7.12e4 があります。 | float * |
| o | 8進整数。 | int * |
| s | 文字列。これは、空白文字(空白、改行、タブ文字のいずれか)に遭遇するまで連続文字を読み取ります。 | char * |
| u | 符号なし10進整数。 | unsigned int * |
| x,X | 16進整数。 | int * |
- 追加引数-- 異なる format 文字列に応じて、関数は一連の追加引数を必要とする場合があります。各引数には、format パラメータで指定された各 % タグを置き換えるための挿入値が含まれます。引数の数は % タグの数と同じである必要があります。
戻り値
成功した場合、この関数は正常にマッチして代入された数を返します。ファイルの終わりに達した場合、または読み取りエラーが発生した場合は、EOF を返します。
例
以下の例は、fscanf() 関数の使い方を示しています。
#include <stdio.h>
#include <stdlib.h>
int main()
{
char str1[10], str2[10], str3[10];
int year;
FILE * fp;
fp = fopen ("file.txt", "w+");
fputs("We are in 2014", fp);
rewind(fp);
fscanf(fp, "%s %s %s %d", str1, str2, str3, &year);
printf("Read String1 |%s|\n", str1 );
printf("Read String2 |%s|\n", str2 );
printf("Read String3 |%s|\n", str3 );
printf("Read Integer |%d|\n", year );
fclose(fp);
return(0);
}
上記のプログラムをコンパイルして実行すると、次の結果が得られます。
Read String1 |We| Read String2 |are| Read String3 |in| Read Integer |2014|その他の拡張