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 的~