getchar

来自cppreference.com
< c‎ | io
 
 
文件输入/输出
类型与对象
函数
文件访问
直接输入/输出
无格式输入/输出
(C95)(C95)
(C95)
(C95)(C95)
(C95)
(C95)
有格式输入
 
在标头 <stdio.h> 定义
int getchar(void);

stdin 读取下一个字符。

等价于 getc(stdin)

参数

(无)

返回值

成功时为获得的字符,失败时为 EOF

若失败由文件尾条件产生,则另外设置 stdin 上的文件尾指示器(见 feof() )。若失败由某些其他错误产生,则设置 stdin 上的错误指示器(见 ferror() )。

示例

演示 getchar 带错误检查

#include <stdio.h>
#include <stdlib.h>
 
int main(void)
{
    for (int ch; (ch = getchar()) != EOF;) // 从 stdin 读/打印 "abcde"
        printf("%c", ch);
 
    // 测试抵达 EOF 的原因。
    if (feof(stdin)) // 若因文件尾条件失败
        puts("End of file reached");
    else if (ferror(stdin)) // 若因别的错误失败
    {
        perror("getchar()");
        fprintf(stderr, "getchar() failed in file %s at line # %d\n",
                __FILE__, __LINE__ - 9);
        exit(EXIT_FAILURE);
    }
 
    return EXIT_SUCCESS;
}

可能的输出:

abcde
End of file reached

引用

  • C23 标准(ISO/IEC 9899:2024):
  • 7.21.7.6 The getchar function (第 TBD 页)
  • C17 标准(ISO/IEC 9899:2018):
  • 7.21.7.6 The getchar function (第 TBD 页)
  • C11 标准(ISO/IEC 9899:2011):
  • 7.21.7.6 The getchar function (第 332 页)
  • C99 标准(ISO/IEC 9899:1999):
  • 7.19.7.6 The getchar function (第 298 页)
  • C89/C90 标准(ISO/IEC 9899:1990):
  • 4.9.7.6 The getchar function

参阅

从文件流获取一个字符
(函数)