char *fgets(char *s, int n, FILE *stream);

参数说明：

s --

指定存放所读取的数据的位置

n -- 指定所读取数据的最大长度(这个最大长度包括了字符串结束符 \0

所占据的存储空间，因此，实际最大读取的有效字符数是 n - 1)

stream --

数据源，是一个文件指针

fgets

函数用于从“输入”字符串中读取指定长度的字符串。这个“输入”字符串既可以是通过fopen等开启的文件流，也可以是直接从键盘键入的

stdin。通俗点说就是，它既可以从一个文本文件中一行、一行地(当然，还需要循环控制语句的配合)读取字符串，又可以直接读取从终端键入的字符串。

结合函数原型中的参数来解释一下这个函数的用途：

从文件流(文件指针 stream)或标准输入流(stdin)中最多读取 n

- 1 个字符，并将它们存储到以 s 为起始地址的内存空间里。

fgets 函数将在以下情况下，停止读取：

1、在读取过程中，遇到换行符 \n

2、在读取过程中，遇到EOF

3、在读取过程中，读取的字符数达到最大限制(已经读取了 n - 1 个)

如果函数执行成功，则返回 s，否则返回 NULL。

fgets 在成功读取字符后，读取的字符串内容以及当前指针所处的状态如下：

strA：目标字符串(如果数据源是文本流，则为 当前行)

strB：读取到的字符串内容

LEN：函数调用时指定的最大读取字符数

情况一：当 strA 的长度 大于 LEN 时

strB 为：从 strA 开始处获取到的 LEN - 1 个字符

指针状态：指针偏移至当前读取完的这个字符之后的位置

例如：

strA 长度为10，LEN 为 5，此时 strB 的内容为 strA 的前4个(取

LEN - 1 个)字符，指针指向 strA 的第5个字符处。

当下一次调用 fgets 函数时，会从 strA 的第5个字符开始读取。

情况二：当 strA + 2(一个字符长度用于存储在终端键入回车后 or strA 自身(行尾，如果是文本流)的换行符

\n，另一个字符长度用于存储字符串本身的结束标识 \0) 的长度 小于 LEN 时

strB 为：strA + 行尾或终端键入回车后的换行符 \n，以及自动追加的字符串结束符 \0

指针状态：指针偏移至下一行

例如：

strA 长度为10，LEN 为 15，此时 strB 的内容为 strA\n\0。

fgets 函数的优点是：

1、读取到的换行符被保存到读取结果中

2、操作的数据源不仅限于标准输入流 stdin

3、允许指定读取字符串的最大长度，有效避免了缓冲区溢出的问题。

BTW：strlen() 的计算结果，是不包括结束符 \0 的~

原文：http://www.cnblogs.com/MyRobotDream/p/3548567.html