fgets()返回值

`fgets()` 函数是 C 标准库中的一个输入函数，用于从指定的流（如文件、标准输入等）读取一行文本到给定的内存缓冲区中。它的原型定义在 `<stdio.h>` 头文件中，函数签名如下：

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

- `str`：指向存储读取数据的字符数组的指针。
- `n`：最大字符数，包括终止符（`\n`），但不包括空字符 `\0`。这个参数决定了最多能读取多少个字符。
- `stream`：指向要读取的文件或输入流的指针。

`fgets()` 函数的返回值是：

- 如果成功读取了一行数据，且没有达到缓冲区的限制（`n`个字符），`str` 将包含读取的数据，末尾会自动添加一个空字符 `\0`，表示字符串结束。
- 如果到达了流的末尾，或者遇到错误（例如，文件关闭、设备已满等），返回的是 `NULL`。
- 如果缓冲区空间不足，`str` 会被设置为 `NULL`，但函数内部实际读取的数据会存放在 `str` 所指向的位置，直到遇到换行符或达到 `n` 个字符为止。