C言語編 標準ライブラリのリファレンス getchar

先頭へ戻る

getchar関数

概要 標準入力から1文字受け取る。
ヘッダ stdio.h
形式 int getchar(void);
引数 なし
戻り値 成功時は入力された文字が返される。読み取りエラーの発生時や、ファイル終了指示子がセットされていた場合は EOF が返される。
詳細 標準入力専用であることを除いて、getc関数と同じである。
fgetc関数と等価であるが、こちらはマクロで実装されている可能性がある。
文字は unsigned char型として読み取られ、int型にキャストした状態で返される。
ファイルの終わりに達していた場合、ファイル終了指示子がセットされる(あるいはすでにセットされているだろう)。読み取りエラーが発生した場合、エラー指示子がセットされる。
戻り値が EOF になるケースは2つあるので、ファイルの終わりに達していたのか、エラーが発生したのかを区別するために、feof関数ferror関数を併用しなければならない。
引数に stdin を指定することで、標準入力から受け取ることも可能である。
注意 マクロとして実装されている可能性があるため、使い方に注意すること。
使用例
#include <stdio.h>
#include <stdlib.h>

int main(void)
{
    int c;

    puts( "文字を入力してください。'q' を入力すると終了します。" );

    for( ;; ){
        c = getchar();
        if( c == EOF ){
            if( feof(stdin) ){
                break;
            }
            else if( ferror(stdin) ){
                fputs( "読み込み中にエラーが発生しました。\n", stderr );
                exit( EXIT_FAILURE );
            }
            else {
                /* 何もしない */
            }
        }
        else if( c == 'q' ){
            break;
        }
        putchar( c );
    }

    return 0;
}

実行結果:

文字を入力してください。'q' を入力すると終了します。
a
a
b
b
abc
abc
q
関連 getc関数は、同じ処理を行うが、対象の入力ストリームを指定できる。また、fgetc関数は、必ず関数として実装されている。
ワイド文字版の getwchar関数がある。
解説章


参考リンク



更新履歴

'2018/4/22 解説中で C95 を(C89 に対して)特別扱いしないように修正。そもそもC言語編は C95ベースなので、余計な説明は省く。

'2018/4/9 全体的に文章を見直し修正。

'2018/1/22 新規作成。



標準ライブラリのリファレンス(名前順)のトップページへ

標準ライブラリのリファレンス(ヘッダ別)のトップページへ

C言語編のトップページへ

Programming Place Plus のトップページへ


はてなブックマーク Pocket に保存 Twitter でツイート Twitter をフォロー
Facebook でシェア Google+ で共有 LINE で送る rss1.0 取得ボタン RSS
管理者情報 プライバシーポリシー