C 语言标准库函数 - fgets() - C 语言标准库

C 语言标准库 <stdio.h> 函数 char fgets(char str, int n, FILE *stream) 从指定的流 stream 读取一行，并把它存储在 str 所指向的字符串内。

当读取 (n-1) 个字符时，或者读取到换行符时，或者到达文件末尾时，它会停止，具体视情况而定。

头文件

#include <stdio.h>

函数原型

下面是 fgets() 函数的原型

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

参数

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

返回值

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

范例

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

/**
 * file: main.c
 * author: 简单教程(www.twle.cn)
 *
 * Copyright © 2015-2065 www.twle.cn. All rights reserved.
 */

#include <stdio.h>

int main()
{
   FILE *fp;
   char str[60];

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

   return(0);
}

假设存在文件 demo.txt，内容如下

这里是 www.twle.cn!
简单教程
简单编程

编译运行以上范例，输出结果如下

$ gcc main.c && ./a.out
这里是 www.twle.cn!