# C 语言标准库函数 getchar

/*********************************************
 * @brief 从标准输入读取单个字符
 * @return 读取到的字符或 EOF
 ********************************************/
int getchar();

!subtitle:说明

从标准输输入流 stdin 读取单个字符。

BASH 中可以使用快捷键 Ctrl + D 终止前的输入流 stdin，使得此函数返回 EOF；常用于退出交互式程序。

!subtitle:参数

无

!subtitle:返回值

• 返回读取到的字符

• 失败时返回 EOF

# 示例

#include <stdio.h>

int main(void)
{
    while (1)
    {
        // 读取输入
        int ch = getchar();

        // 退出，可以通过 Ctrl + D 实现
        if (ch == EOF)
        {
            break; 
        }

        // ...
    }

    return 0;
}

# 推荐阅读

• C 语言标准库函数 putchar

• C 语言标准库函数 puts

• C 语言标准库函数 gets

• getchar - cppreference

• getchar - POSIX

# 参考标准

• C23 standard (ISO/IEC 9899:2024):

  • 7.21.7.6 The getchar function (p: TBD)

• C17 standard (ISO/IEC 9899:2018):

  • 7.21.7.6 The getchar function (p: TBD)

• C11 standard (ISO/IEC 9899:2011):

  • 7.21.7.6 The getchar function (p: 332)

• C99 standard (ISO/IEC 9899:1999):

  • 7.19.7.6 The getchar function (p: 298)

• C89/C90 standard (ISO/IEC 9899:1990):

  • 4.9.7.6 The getchar function