fscanf()函数

1 函数原型

fscanf()：从指定流stream读取格式化数据，函数原型如下：

复制

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

cstdio库描述如下：

复制

Read formatted data from stream

1. Reads data from the stream and stores them according to the parameter format into the locations pointed by the additional arguments.

2. The additional arguments should point to already allocated objects of the type specified by their corresponding format specifier within the format string.

2 参数

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

• 参数stream是fscanf()函数要读取的流，类型为FILE*；stream可以是文件流或标准输入流；当是文件流时，stream就是fopen()函数的返回值；当是标准输入流时，stream就是stdin；
• format ：格式字符串，与scanf()函数一致；
• … ： 可变数量的参数，与scanf()函数一致。
  

3 返回值

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

• 读取成功，则返回成功读取的项数；
• 读取失败，则返回EOF。
  

cstdio库描述如下：

复制

1. On success, the function returns the number of items of the argument list successfully filled. 

2. This count can match the expected number of items or be less (even zero) due to a matching failure, a reading error, or the reach of the end-of-file.

3. If a reading error happens or the end-of-file is reached while reading, the proper indicator is set (feof or ferror). And, if either happens before any data could be successfully read, EOF is returned.

fscanf()函数，预期读取m项，成功读取n项：

[td]

读取比较	读取状况	读取结果	返回值	状态设置
n=m	全部成功读取	读取成功	返回n	NA
0<n<m	部分成功读取，遇到匹配失败	读取成功	返回n	NA
0<n<m	部分成功读取，遇到读取错误	读取成功	返回n	设置错误指示符(ferror)
0<n<m	部分成功读取，遇到文件末尾	读取成功	返回n	设置文件结束指示符(feof)
n=0	未成功读取任何项，遇到匹配失败	读取成功	返回n	NA
n=0	未成功读取任何项，遇到读取错误	读取失败	返回EOF	设置错误指示符(ferror)
n=0	未成功读取任何项，遇到文件末尾	读取失败	返回EOF	设置文件结束指示符(feof)

4 比较

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

• fscanf()函数从指定流stream中读取格式化数据；scanf()函数从标准输入流stdin中读取格式化数据；
• 将fscanf()函数的参数stream指定为stdin，则fscanf()函数的功能和scanf()函数的功能完全相同。
  

5 示例5.1 示例1

使用fscanf()函数读文件并打印，示例代码如下所示：

复制

int main()

{

   //

   float floatData = 0.0f;



   FILE* fp = NULL;

   //

   if ((fp = fopen("1.txt", "r")) == NULL)

   {

      perror("Failed to open file ");

      exit(1);

   }

   //

   printf("scanf()函数读文件：\n");

   while (fscanf(fp, " %f", &floatData) != EOF)

   {

      printf("floatData = %f\n", floatData);

   }

   //

   fclose(fp);

   //

   printf("\n");

   //

   printf("scanf()函数读stdin：\n");

   while (fscanf(stdin, " %f", &floatData) != 0)

   {

      printf("floatData = %f\n", floatData);

   }

   //

   return 0;

}

文件内容如下图所示：

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

5.2 示例2

检查fscanf()函数成功读取的项数，示例代码如下所示：

复制

int main()

{

   //

   FILE* fp = NULL;

   int intData1 = 0;

   int intData2 = 0;

   int intData3 = 0;

   //

   fp = fopen("1.txt", "r");



   if (fp == NULL) {

      perror("Failed to open file ");

      exit(1);

   }

   //

   int rdItem = fscanf(fp, " %d %d %d", &intData1, &intData2, &intData3);

   printf("intData1 = %d\n", intData1);

   printf("intData2 = %d\n", intData2);

   printf("intData3 = %d\n", intData3);

   printf("成功读取项数 ：%d\n", rdItem);

   //

   fclose(fp);

   //

   return 0;

}

当文件内容为3个整数，全部成功读取，代码运行结果如下图所示：

当文件内容为2个整数和1个字符串，部分成功读取，遇到匹配失败，代码运行结果如下图所示：

当文件内容3个字符串，未成功读取任何项，遇到匹配失败，代码运行结果如下图所示：

当文件内容为空，未成功读取任何项，遇到文件末尾，代码运行结果如下图所示：

工作方式类似于 scanf()，但 fscanf() 从指定的文件流读取输入，而不是从标准输入（stdin）。

函数返回成功匹配和赋值的项目数，如果到达文件末尾或发生读取错误，则返回EOF。

fscanf()函数是C语言标准库中的一个函数，用于从文件中读取格式化的数据。

直接操作文件流，避免逐字符读取，适合大数据量处理

函数返回成功匹配和赋值的项目数，不包括空格和换行符。如果遇到输入结束（EOF），则返回 EOF。

fscanf()函数的工作原理是根据format字符串中指定的格式，从stream指向的文件流中读取数据，并将读取的数据存储在由额外参数指定的内存位置。

在使用fscanf()函数时，需要根据返回值进行错误处理

fscanf() 通过灵活的格式字符串实现了对文件数据的高效解析，但其行为受空白符处理、格式说明符和返回值影响的复杂规则制约。

#include <stdio.h>

int main() {
    FILE *file;
    int integer;
    float floating_point;
   
    // 打开文件
    file = fopen("data.txt", "r");
    if (file == NULL) {
        perror("Error opening file");
        return 1;
    }
   
    // 从文件中读取整数和浮点数
    fscanf(file, "%d %f", &integer, &floating_point);
   
    // 输出读取的数据
    printf("Integer: %d\n", integer);
    printf("Floating Point: %f\n", floating_point);
   
    // 关闭文件
    fclose(file);
   
    return 0;
}

fscanf()函数是C语言中的一个输入函数，用于从文件中按照指定格式读取数据。

使用时注意格式匹配、缓冲区安全、返回值检查。

fscanf() 函数按照 format 字符串中指定的格式从 stream 指向的文件中读取数据，并将读取的数据存储在随后的参数中提供的地址中。

通过fscanf()函数，可以灵活地从文件中读取数据并进行处理，适用于需要解析有规律的文件内容的场景。

从文件流 stream 中按 format 指定的格式读取数据，并将结果存入后续参数指向的变量中

fscanf()函数通常与fprintf()函数配合使用，后者用于向文件写入格式化的数据。

对于复杂输入，建议先用 fgets() 读取整行，再用 sscanf() 解析。

务必检查 fscanf() 的返回值

为每个要读取的数据项提供一个对应的指针参数。

fscanf() 是 C 语言标准库中的一个输入函数，用于从文件流（FILE *）中读取格式化的数据。