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

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

説明

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 の場合)
type1つの文字で、読み取るデータ型とデータの読み取り方法を指定します。詳細は次の表を参照してください。

fscanf 型指定子:

型適合する入力引数の型
c単一文字:次の文字を読み取ります。1 以外の幅 width が指定された場合、関数は width 個の文字を読み取り、パラメータを介してそれらを配列の連続する位置に格納します。末尾にヌル文字は追加されません。char *
d10進整数:数値の前の + または - 記号はオプションです。int *
e,E,f,g,G浮動小数点数:小数点、オプションの前置符号 + または -、オプションの後置文字 e または E、および10進数字を含みます。有効な例として -732.103 と 7.12e4 があります。float *
o8進整数。int *
s文字列。これは、空白文字(空白、改行、タブ文字のいずれか)に遭遇するまで連続文字を読み取ります。char *
u符号なし10進整数。unsigned int *
x,X16進整数。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|

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

その他の拡張