能否详细解释一下如何使用 fgets 函数进行文件读取操作？

当然，`fgets()`函数在C语言中用于从指定位置开始读取一行文本数据（包括空格和终止符）到一个缓冲区中。它的基本语法如下：

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

其中：
- `str`: 指向一个足够大的字符数组，用来存储读取的字符串。
- `n`: 表示最多允许读取的字符数（不包括结束符'\0'）。如果文件读取超过此长度，将不再继续读取。
- `stream`: 指向你要读取的文件描述符，通常是`stdin`、`stdout`、`stderr`或打开的文件指针。

这里是一个简单的例子，演示了如何使用`fgets()`从文件中读取一行文本：

#include <stdio.h>
#include <string.h>

#define MAX_LINE_LENGTH 100

int main() {
    FILE *file = fopen("example.txt", "r"); // 打开文件
    if (file == NULL) {
        perror("Failed to open file");
        return 1;
    }

    char line[MAX_LINE_LENGTH]; // 定义一个缓冲区来存储读取的行
    size_t num_read;

    if ((num_read = fgets(line, sizeof(line), file)) != NULL) {
        line[num_read - 1] = '\0'; // 去掉最后一行结束符'\n'
        printf("Line read from file: %s\n", line);
    } else {
        perror("Error reading from file");
    }

    fclose(file); // 关闭文件
    return 0;
}

在这个例子中，我们首先检查文件是否成功打开，然后读取一行文本，并去掉最后的换行符。如果文件操作出错，我们会显示错误信息并关闭文件。