C言語のungetc()関数とは？文字をストリームに押し戻す方法を解説

ungetc()関数の概要

C言語のungetc()関数は、一度読み込んだ1文字をストリームに押し戻す（プッシュバックする）ための関数です。押し戻された文字は、その後の読み込み操作で再度取得することができます。

この関数は、例えば「ある文字を読んでみて、それが意図したものではなかった場合に元に戻したい」といった場面で役立ちます。トークナイザやパーサの実装などでよく使われるテクニックです。

ungetc()の構文

int ungetc(int character, FILE *stream);

引数

• character … ストリームに押し戻す文字（int型で指定します）
• stream … 対象となるFILEオブジェクトへのポインタ

戻り値

成功した場合は押し戻された文字が返されます。失敗した場合はEOFが返されます。

注意点

• 押し戻しが保証されているのは1文字だけです。連続して複数回呼び出しても、すべての文字が戻るとは限りません。
• EOFを押し戻すことはできません。
• 押し戻された文字は、ファイルの読み取り位置を巻き戻すわけではなく、ストリーム上で次に読み込まれる位置に挿入されます。

サンプルコード

以下は、C言語におけるungetc()の使用例です。

#include <stdio.h>

int main(void) {
    int c;
    // '0' が入力されるまで文字を読み込んで出力する
    while ((c = getchar()) != '0')
        putchar(c);
    // 読み込んだ文字('0')を標準入力ストリームに押し戻す
    ungetc(c, stdin);
    // 押し戻した文字を再度読み込む
    c = getchar();
    putchar(c);
    puts("");
    printf("The End!");
    return 0;
}

実行結果

s a b c t h 0
0
The End!

プログラムの解説

このプログラムでは、まずint型の変数cを宣言しています。

1. getchar()を使って標準入力から1文字ずつ読み込み、文字「0」が現れるまでputchar()で順番に出力します。
2. 「0」を読み込んだ時点でループを抜けますが、このとき変数cには「0」が格納されています。
3. ungetc(c, stdin)によって、この「0」を標準入力ストリームに押し戻します。
4. その後、もう一度getchar()を呼び出すと、押し戻された「0」を再び読み込むことができ、putchar()で出力されます。
5. 最後に改行を出力し、「The End!」と表示して終了します。

このようにungetc()を使うことで、「読みすぎた1文字」をストリームに戻し、あたかもまだ読み込んでいないかのように扱うことができます。入力の解析処理などで非常に便利な関数です。