char *fgets

`fgets` 是 C 语言中的一个函数，用于从文件流中读取一行字符。它的函数原型如下：

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

其中，`str` 是一个指向字符数组的指针，用于存储读取到的字符；`n` 是最大读取字符数；`stream` 是一个指向文件流的指针，用于指定从哪个文件流中读取。

该函数会从文件流中读取字符，直到遇到换行符（包括换行符），或者读取字符数达到 `n-1`，或者遇到文件结束符。读取到的字符会存储在 `str` 中，并在末尾添加一个 null 字符 `\0`。

函数会返回 `str` 的值，如果读取成功，则返回 `str` 的地址；如果读取失败或者遇到文件结束，则返回 `NULL`。

注意：使用该函数时需要确保 `str` 指向的字符数组具有足够的空间来存储读取到的字符，否则可能会导致缓冲区溢出的问题。

相关问题

char * fgets(char *restrict str,int size,FILE* restrict stream);

`fgets` 是C语言标准库中的一个函数，用于从指定的文件流中读取一行数据，并存储到指定的字符串中。它的函数原型如下：

char *fgets(char *restrict str, int size, FILE *restrict stream);

参数说明：
- `str`：指向用于存储读取到的字符串的字符数组的指针。
- `size`：要读取的最大字符数（包括结尾的空字符）。
- `stream`：要读取的文件流指针。

返回值：
- 如果成功读取到一行数据，则返回指向存储在 `str` 中的字符串的指针。
- 如果到达文件末尾或发生错误，则返回 `NULL`。

例如，要从名为 `input.txt` 的文件中逐行读取数据，并将每行数据打印出来，可以使用以下代码：

#include <stdio.h>

int main() {
    FILE *file = fopen("input.txt", "r");
    if (file == NULL) {
        printf("无法打开文件\n");
        return 1;
    }

    char line[100];
    while (fgets(line, sizeof(line), file) != NULL) {
        printf("%s", line);
    }

    fclose(file);
    return 0;
}

在上面的示例中，我们首先使用 `fopen` 函数以只读模式打开名为 `input.txt` 的文件。然后，我们使用 `fgets` 函数逐行读取文件中的数据，每次读取一行数据存储到 `line` 数组中。最后，我们通过循环打印每行数据，并在循环结束后关闭文件。

需要注意的是，`fgets` 函数会将换行符 `\n` 一起读取并存储到字符串中，所以在打印时不需要额外添加换行符。另外，为了安全起见，我们在定义 `line` 数组时给定了足够的大小来存储读取到的行数据。

/usr/include/stdio.h:622:14: note: declared here extern char *fgets (char *__restrict __s, int __n, FILE *__restrict __stream)

这是一个 C 语言标准库头文件 stdio.h 中的函数声明。这个函数是用来从指定的文件流中读取一行字符串的。它的函数原型声明是：

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

其中，第一个参数 s 是一个字符数组，用于存储读取到的字符串；第二个参数 n 是指定要读取的字符数，通常是 s 数组长度减 1，以保证最后一个字符为 '\0'（字符串结束符）；第三个参数 stream 则是要读取的文件流指针。该函数会读取文件流中的数据，直到遇到换行符 '\n'、文件结束符 EOF 或者读取的字符数达到 n-1 为止。函数会自动在读取到换行符或文件结束符时在字符串末尾添加 '\0'，以使其成为一个 C 风格的字符串。函数返回值为 s 指针，如果读取失败则返回 NULL。