Namespaces
Variants

getchar

From cppreference.net
< c ‎ | io
ヘッダーで定義 <stdio.h>
int getchar ( void ) ;

stdin から次の文字を読み取ります。

getc ( stdin ) と同等です。

目次

パラメータ

(なし)

戻り値

成功時に取得された文字、または EOF 失敗時。

失敗がファイル終端状態によって引き起こされた場合、さらに eof インジケータを設定します( feof() を参照)。 stdin に対して設定されます。失敗が他の何らかのエラーによって引き起こされた場合、 error インジケータを設定します( ferror() を参照)。 stdin に対して設定されます。

getchar を使用したエラーチェックのデモンストレーション

#include <stdio.h>
#include <stdlib.h>
int main(void)
{
    for (int ch; (ch = getchar()) != EOF;) // read/print "abcde" from stdin
        printf("%c", ch);
    // Test reason for reaching EOF.
    if (feof(stdin)) // if failure caused by end-of-file condition
        puts("End of file reached");
    else if (ferror(stdin)) // if failure caused by some other error
    {
        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 getchar関数 (p: 未定)
  • C17規格 (ISO/IEC 9899:2018):
  • 7.21.7.6 getchar関数 (p: TBD)
  • C11規格 (ISO/IEC 9899:2011):
  • 7.21.7.6 getchar関数 (p: 332)
  • C99規格 (ISO/IEC 9899:1999):
  • 7.19.7.6 getchar関数 (p: 298)
  • C89/C90標準 (ISO/IEC 9899:1990):
  • 4.9.7.6 getchar関数

関連項目

ファイルストリームから文字を取得する
(関数)