【C语法学习】fscanf()函数

1 函数原型

fscanf()：从指定流stream读取格式化输入，stream可以是创建的文件流，也可以是C语言标准输入流stdin，函数原型如下：

int fscanf(FILE *stream, const char *format, ...)

2 参数

fscanf()函数参数包括两部分：

1. FILE *stream：指向FILE结构类型的指针，该指针是fopen()函数返回值；
2. const char *format,…：与scanf()函数的参数完全相同。

3 返回值

fscanf()函数返回值类型为int型：

1. 读文件成功，则返回成功读取的项数；
2. 读文件失败，则返回EOF。

C语言标准描述如下：

Each of these functions returns the number of fields successfully converted and assigned; the return value does not include fields that were read but not assigned. A return value of 0 indicates that no fields were assigned. 
If an error occurs, or if the end of the file stream is reached before the first conversion, the return value is EOF for fscanf or WEOF for fwscanf.

4 比较

fscanf()函数和scanf()函数的工作原理类似，差异如下：

1. fscanf()函数从指定流stream中获取输入；
2. scanf()函数从标准输入流stdin中获取输入；
3. 将fscanf()函数的参数stream指定为stdin，则fscanf()函数的功能和scanf()函数的功能完全相同。

5 示例

示例代码如下图所示：

int main()
{
   float f1 = 0.0;
   float f2 = 0.0;
   float f3 = 0.0;
   float f4 = 0.0;
   float f5 = 0.0;
   FILE* fp;

   if ((fp = fopen("1.txt", "r")) == NULL)
   {
      printf("Failed to open file\n");
      exit(1);
   }

   int rt = fscanf(fp, "%f %f %f %f %f", &f1, &f2, &f3, &f4, &f5);
   printf("f1 = %f\n", f1);
   printf("f2 = %f\n", f2);
   printf("f3 = %f\n", f3);
   printf("f4 = %f\n", f4);
   printf("f5 = %f\n", f5);
   printf("rt = %d\n", rt);
   printf("\n");

   return 0;
}

文件1.txt内容如下图所示：

代码运行结果如下图所示：

分析代码及运行结果：

1. fscanf()函数从1.txt文件中读取浮点数，并赋值给float型变量f1、f2、f3、f4、f5；
2. fscanf()函数返回值为rt=5表示成功读取并赋值的项的数量。

2.txt文件为空，修改代码读取文件2.txt，代码运行结果如下图所示：

分析代码及运行结果：因为2.txt文件为空，所scanf()第一次读取时首先读到文件结束符，所以返回EOF=-1。