C语言 <stdio.h> fgets() 函数

• 

  描述

  C库函数char *fgets(char *str, int n, FILE *stream)从指定的流中读取一行并将其存储到str指向的字符串中。当读取（n-1）个字符，读取换行符或到达文件结尾（以先到者为准）时，它将停止。
• 

  声明

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

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

  参数

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

  返回值

  成功后，函数将返回相同的str参数。如果遇到文件末尾且未读取任何字符，则str的内容保持不变，并返回空指针。如果发生错误，则返回空指针。

  示例

  以下示例显示fgets（）函数的用法-

  
  #include <stdio.h> 
  
  int main () {
     FILE *fp;
     char str[60];
  
     /* opening file for reading */
     fp = fopen("file.txt" , "r");
     if(fp == NULL) {
        perror("Error opening file");
        return(-1);
     }
     if( fgets (str, 60, fp)!=NULL ) {
        /* writing content to stdout */
        puts(str);
     }
     fclose(fp);
     
     return(0);
  }
  

  让我们假设，我们有一个文本文件file.txt，其内容如下。该文件将用作示例程序的输入-

  
  We are in 2020
  

  现在，让我们编译并运行上面的程序，它将产生以下结果-

  
  We are in 2020