fgets()函数的概念和使用案例

fgets() 是 C 语言标准库中的一个函数，用于从文件流中读取一行数据。它通常用于从标准输入（stdin）、文件或其他数据流中读取字符串。

概念

fgets() 函数的原型定义在 <stdio.h> 头文件中，如下所示：

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

参数说明：

• str: 指向一个字符数组的指针，该数组用于存储读取的字符串。
• n: 指定要读取的最大字符数，这包括末尾的空字符（null terminator）。
• stream: 指向 FILE 对象的指针，该对象标识了要读取的输入流。
  fgets() 读取直到以下任一条件首次发生为止：
• 读取了 n-1 个字符。
• 遇到了换行符（'\n'），该换行符会被读取并存储在字符串中。
• 遇到了文件结束标记（EOF）。
  读取完成后，fgets() 会自动在字符串的末尾添加一个空字符（'\0'）来表示字符串的结束。

使用案例

以下是一个使用 fgets() 从标准输入读取一行文本的简单示例：

#include <stdio.h>
int main() {
    char buffer[256]; // 创建一个足够大的缓冲区来存储输入的行
    printf("Enter a line of text: ");
    if (fgets(buffer, sizeof(buffer), stdin) != NULL) {
        // 输入成功，打印读取的行
        printf("You entered: %s", buffer);
    } else {
        // 输入失败
        perror("Error reading input");
        return 1;
    }
    return 0;
}

在这个例子中，我们定义了一个字符数组 buffer 作为缓冲区，用来存储用户输入的行。我们调用 fgets() 从 stdin 读取最多 sizeof(buffer) - 1 个字符（因为最后一个字符是为空字符保留的）。如果读取成功，fgets() 会返回一个指向 buffer 的指针；如果发生错误或遇到 EOF，它会返回 NULL。
请注意，如果输入的行超过了缓冲区的大小，fgets() 只会读取缓冲区大小减一的字符，并保留剩余的字符在输入流中，这可能导致下一次调用 fgets() 时直接读取剩余的字符。因此，在使用 fgets() 时，确保缓冲区足够大以容纳可能的最长输入行，或者编写额外的逻辑来处理长行。