getchar | Programming Place Plus　Ｃ言語編　標準ライブラリのリファレンス

トップページ – Ｃ言語編 – 標準ライブラリのリファレンス（名前順）

トップページ – Ｃ言語編 – 標準ライブラリのリファレンス（ヘッダ別）

getchar関数 🔗

概要

標準入力から１文字受け取る。
ヘッダ

stdio.h
形式

int getchar(void);
引数

なし
戻り値

成功時は入力された文字が返される。読み取りエラーの発生時や、ファイル終了指示子がセットされていた場合は EOF が返される。
詳細

標準入力専用であることを除いて、getc関数と同じである。

fgetc関数と等価であるが、こちらはマクロで実装されている可能性がある。

文字は unsigned char型として読み取られ、int型にキャストした状態で返される。

ファイルの終わりに達していた場合、ファイル終了指示子がセットされる（あるいはすでにセットされているだろう）。読み取りエラーが発生した場合、エラー指示子がセットされる。

戻り値が EOF になるケースは２つあるので、ファイルの終わりに達していたのか、エラーが発生したのかを区別するために、feof関数と ferror関数を併用しなければならない。

引数にstdinを指定することで、標準入力から受け取ることも可能である。
注意

マクロとして実装されている可能性があるため、使い方に注意すること。
使用例 
#include <stdio.h>
#include <stdlib.h>

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

    for (;;) {
        int 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);
    }
}

実行結果：

文字を入力してください。'q' を入力すると終了します。
a
a
b
b
abc
abc
q
関連

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


参考リンク 🔗

本ページはアフィリエイトプログラムによる収益を得ています。
以下のリンクから商品を購入されると、Programming Place 管理者に紹介料が支払われています。


更新履歴 🔗

　解説中で C95 を（C89 に対して）特別扱いしないように修正。そもそもＣ言語編は C95ベースなので、余計な説明は省く。

　全体的に文章を見直し修正。

　新規作成。


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

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

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

Programming Place Plus のトップページへ

はてなブックマーク に保存 Pocket に保存 Facebook でシェア
X で ポスト／フォロー LINE で送る noteで書く
rss1.0 取得ボタン RSS 管理者情報 プライバシーポリシー
先頭へ戻る