std::ungetc

 

C++

コンパイラサポート

フリースタンディングとホスト

言語

標準ライブラリ

標準ライブラリヘッダー

名前付き要件

機能テストマクロ (C++20)

言語サポートライブラリ

コンセプトライブラリ (C++20)

診断ライブラリ

メモリ管理ライブラリ

メタプログラミングライブラリ (C++11)

汎用ユーティリティライブラリ

コンテナライブラリ

イテレータライブラリ

Rangesライブラリ (C++20)

アルゴリズムライブラリ

文字列ライブラリ

テキスト処理ライブラリ

数値ライブラリ

日付と時刻ライブラリ

入出力ライブラリ

ファイルシステムライブラリ (C++17)

並行サポートライブラリ (C++11)

実行制御ライブラリ (C++26)

Technical specifications (技術仕様)

シンボルインデックス

外部ライブラリ

 

入出力ライブラリ

I/Oマニピュレータ

出力関数 (C++23)

C形式I/O

バッファ

basic_streambuf

basic_filebuf

basic_stringbuf

basic_spanbuf (C++23)

strstreambuf (C++98/26*)

basic_syncbuf (C++20)

ストリーム

抽象化

ios_base

basic_ios

basic_istream

basic_ostream

basic_iostream

ファイルI/O

basic_ifstream

basic_ofstream

basic_fstream

文字列I/O

basic_istringstream

basic_ostringstream

basic_stringstream

配列I/O

basic_ispanstream (C++23)

basic_ospanstream (C++23)

basic_spanstream (C++23)

istrstream (C++98/26*)

ostrstream (C++98/26*)

strstream (C++98/26*)

同期出力

basic_osyncstream (C++20)

型

streamoff

streamsize

fpos

エラーカテゴリインターフェース

iostream_category (C++11)

io_errc (C++11)

 

C形式I/O

型とオブジェクト
FILE fpos_t	stdinstdoutstderr
関数
ファイルアクセス fopen freopen fclose fflush fwide setbuf setvbuf 直接入出力 fread fwrite 非書式化入出力 fgetcgetc fgets fputcputc fputs getchar gets (C++14まで) putchar puts ungetc fgetwcgetwc fgetws fputwcputwc fputws getwchar putwchar ungetwc 書式付き入力 scanffscanfsscanf vscanfvfscanfvsscanf (C++11)(C++11)(C++11)     wscanffwscanfswscanf vwscanfvfwscanfvswscanf (C++11)(C++11)(C++11)	書式付き出力 printffprintfsprintfsnprintf (C++11) vprintfvfprintfvsprintfvsnprintf (C++11)     wprintffwprintfswprintf vwprintfvfwprintfvswprintf ファイルポジショニング ftell fgetpos fseek fsetpos rewind エラーハンドリング clearerr feof ferror perror ファイル操作 remove rename tmpfile tmpnam

 

ヘッダ<cstdio>で定義
int ungetc( int ch, std::FILE *stream );

ch が EOF でない場合、ストリーム stream に関連付けられた入力バッファに文字 ch（unsigned char として再解釈される）を、後続の stream からの読み込み操作でその文字が取得されるようにプッシュします。ストリームに関連付けられた外部デバイスは変更されません。

ストリームの再配置操作である std::fseek、std::fsetpos、および std::rewind は、ungetc の効果を破棄します。

読み込みまたは再配置を挟まずに ungetc が複数回呼び出された場合、失敗する可能性があります（つまり、サイズ 1 のプッシュバックバッファは保証されますが、それより大きいバッファは実装定義です）。複数の ungetc が成功した場合、読み込み操作はプッシュバックされた文字を ungetc と逆の順序で取得します。

ch が EOF の場合、操作は失敗し、ストリームは影響を受けません。

正常に呼び出された ungetc は、ファイルの終端状態フラグ std::feof をクリアします。

バイナリストリームに対して ungetc を正常に呼び出すと、ストリーム位置指示子が 1 つ減少します（ストリーム位置指示子がゼロだった場合の動作は不定です）。

テキストストリームに対して ungetc を正常に呼び出すと、ストリーム位置指示子は不定な方法で変更されますが、プッシュバックされたすべての文字が読み込み操作で取得された後、ストリーム位置指示子は ungetc 呼び出し前の値と等しくなることが保証されます。

パラメータ

文字	-	入力ストリームバッファにプッシュする文字
stream	-	文字を戻すファイルストリーム

戻り値

成功した場合、ch が返されます。

失敗した場合、EOF が返され、指定されたストリームは変更されません。

注記

プッシュバックバッファのサイズは、実際には 4k (Linux, MacOS) から 4 (Solaris) や保証されている最小値 1 (HPUX, AIX) まで様々です。

プッシュバックされる文字が外部文字シーケンスのその位置にある文字と等しい場合、プッシュバックバッファの見えるサイズが大きくなることがあります（実装では単にファイル読み込み位置指示子をデクリメントし、プッシュバックバッファを維持しないことがあります）。

例

std::ungetc の本来の目的である std::scanf の実装における使用法を示しています。

このコードを実行

#include <cctype>
#include <cstdio>
 
void demo_scanf(const char* fmt, std::FILE* s)
{
    while (*fmt != '\0') {
        if (*fmt == '%') {
            switch (*++fmt) {
                case 'u': {
                    int c{};
                    while (std::isspace(c=std::getc(s))) {}
                    unsigned int num{};
                    while (std::isdigit(c)) {
                        num = num*10 + c-'0';
                        c = std::getc(s);
                    }
                    std::printf("%%u scanned %u\n", num);
                    std::ungetc(c, s);
                    break;
                }
                case 'c': {
                    int c = std::getc(s);
                    std::printf("%%c scanned '%c'\n", c);
                    break;
                }
            }
        } else {
            ++fmt;
        }
    }
}
 
int main()
{
    if (std::FILE* f = std::fopen("input.txt", "w+")) {
        std::fputs("123x", f);
        std::rewind(f);
        demo_scanf("%u%c", f);
        std::fclose(f);
    }
}

出力

%u scanned 123
%c scanned 'x'

関連項目

fgetcgetc	ファイルストリームから1文字取得する (関数)
C言語のドキュメント ungetc