C 库函数 - fgets()

描述

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

声明

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

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

参数

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

返回值

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

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

实例

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

  1. #include <stdio.h>
  3. int main()
  4. {
  5.    FILE *fp;
  6.    char str[60];
  8.    /* 打开用于读取的文件 */
  9.    fp = fopen("file.txt" , "r");
  10.    if(fp == NULL) {
  11.       perror("打开文件时发生错误");
  12.       return(-1);
  13.    }
  14.    if( fgets (str, 60, fp)!=NULL ) {
  15.       /* 向标准输出 stdout 写入内容 */
  16.       puts(str);
  17.    }
  18.    fclose(fp);
  20.    return(0);
  21. }

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

  1. We are in 2014

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

  1. We are in 2014

fgets(st,n,stdin) 中的 stdin 表示标准输入，一般是从输入设备如键盘的缓冲区输入。

这里函数的作用是判断文件是否为空，如果是不执行下面的语句：

  1. char * s_gets(char * st, int n)  //输入文本(作家)函数
  2. {
  3.     char * ret_val;
  4.     char * find;
  5.     ret_val = fgets(st, n, stdin);       
  6.     if (ret_val)
  7.     {
  8.         find = strchr(st, '\n');  //查找换行符
  9.         if (find)  //如果地址不是NULL
  10.             *find = '\0';  //在此处放置一个空字符
  11.         else
  12.             while (getchar() != '\n')
  13.                 continue;
  14.     }
  15.     return ret_val;
  16. }

fgets(st,n,stdin) 中的 stdin 表示标准输入，一般是从输入设备如键盘的缓冲区输入。

这里函数的作用是: 将键盘输入存入 ret_val 中并判断输入是否为空或者错误，如果是不执行下面的语句。

  1. char * s_gets(char * st, int n)  // 输入文本(作家)函数
  2. {
  3.     char * ret_val;
  4.     char * find;
  5.     ret_val = fgets(st, n, stdin);       
  6.     if (ret_val)
  7.     {
  8.         find = strchr(st, '\n');  //查找换行符
  9.         if (find)  //如果地址不是NULL
  10.             *find = '\0';  //在此处放置一个空字符
  11.         else
  12.             while (getchar() != '\n')
  13.                 continue;
  14.     }
  15.     return ret_val;
  16. }