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