C语言fgets()函数（以指定长度读取文件中的字符，并存入字符数组变量中）

Posted 2021-12-28 Dontla

C语言fgets()函数（以指定长度读取文件中的字符，并存入字符数组变量中）

需要引入C 标准库 - <stdio.h>

文章目录

• • 描述
  • 声明
  • 参数
  • 返回值
  • 实例
  • 测试（确实只能读n-1个字符）

描述

C 库函数 char *fgets(char *str, int n, FILE *stream) 从指定的流 stream 读取一行，并把它存储在 str 所指向的字符串内。当读取 (n-1) 个字符时，或者读取到换行符时，或者到达文件末尾时，它会停止，具体视情况而定。

声明

下面是 fgets() 函数的声明。

char *fgets(char *str, int n, FILE *stream)

参数

• str – 这是指向一个字符数组的指针，该数组用来存储要读取的字符串。
• n – 这是要读取的最大字符数（包括最后的空字符）。通常是使用以 str 传递的数组长度。
• stream – 这是指向 FILE 对象的指针，该 FILE 对象标识了要从中读取字符的流。

返回值

如果成功，该函数返回相同的 str 参数。如果到达文件末尾或者没有读取到任何字符，str 的内容保持不变，并返回一个空指针。

如果发生错误，返回一个空指针。

实例

下面的实例演示了 fgets() 函数的用法。

#include <stdio.h>

int main()

   FILE *fp;
   char str[60];

   /* 打开用于读取的文件 */
   fp = fopen("file.txt" , "r");
   if(fp == NULL) 
      perror("打开文件时发生错误");
      return(-1);
   
   if( fgets (str, 60, fp)!=NULL ) 
      /* 向标准输出 stdout 写入内容 */
      puts(str);
   
   fclose(fp);
   
   return(0);

假设我们有一个文本文件 file.txt，它的内容如下。文件将作为实例中的输入：

We are in 2014

让我们编译并运行上面的程序，这将产生以下结果：

We are in 2014

测试（确实只能读n-1个字符）

test.txt

abcdefghijklmn

main.cpp

#include <stdio.h>
#include <stdlib.h>
#include <string.h>

int main()

    FILE* fp;
    char str[60];
    fopen_s(&fp ,"test.txt", "r");
    if (fp == NULL) 
        perror("打开文件时发生错误");
        return(-1);
    
    fgets(str, 6, fp);
    printf("%s\\n", str);
    return(0);

运行结果：

abcde

参考文章：C 库函数 - fgets()