#C 语言标准库函数 fgetc

/*********************************************
 * @brief 从文件中读取一个字符
 * @param fp 文件流
 * @return 读取到的字符
 ********************************************/
int fgetc(FILE* fp);

说明

从文件流 fp 中读取 1 个字节的字符。

失败时返回 EOF；不区分文件结束和错误，调用者需要使用 feof 和 ferror 进行判断。

参数

• fp - 要读取的文件流

返回值

• 返回读取到的字符，以 unsigned char 转换为 int 的形式（0~255）
• 失败时返回 EOF

#示例

#include <stdio.h>

int main(void)
{
    // 打开文件
    FILE* fp = fopen("/dev/random", "rb"); // "/dev/random" 是 Linux 系统上的随机数生成器设备

    if (fp == NULL)
    {
        perror("文件打开失败");
        return 1;
    }

    for (int i = 0; i < 10; i += 1)
    {
        int ch = fgetc(fp); // 返回 int

        if (ch == EOF) // 失败检查
            break;

        printf("'%c'(%d)\n", (char)ch, ch);
    }

    // 关闭文件
    fclose(fp);

    return 0;
}

运行结果：

't'(116)
'F'(70)
'ª'(170)
'°'(176)
'¹'(185)
'e'(101)
'֧(216)
'&'(38)
'¼'(188)
''(22)

#推荐阅读

• C 语言标准库函数 fread
• C 语言标准库函数 fwrite
• C 语言标准库函数 fgets
• C 语言标准库函数 fputc
• C 语言标准库函数 fputs
• fgetc - cppreference
• fgetc - POSIX

#参考标准

• C23 standard (ISO/IEC 9899:2024):
  • 7.21.7.1 The fgetc function (p: TBD)
• C17 standard (ISO/IEC 9899:2018):
  • 7.21.7.1 The fgetc function (p: 240-241)
• C11 standard (ISO/IEC 9899:2011):
  • 7.21.7.1 The fgetc function (p: 330)
• C99 standard (ISO/IEC 9899:1999):
  • 7.19.7.1 The fgetc function (p: 296)
• C89/C90 standard (ISO/IEC 9899:1990):
  • 4.9.7.1 The fgetc function