std:: ungetwc

ch が WEOF と等しくない場合、ワイド文字 ch をストリーム stream に関連付けられた入力バッファにプッシュし、その後の stream からの読み取り操作でそのワイド文字が取得されるようにします。ストリームに関連付けられた外部デバイスは変更されません。

ストリームの再位置付け操作 std::fseek 、 std::fsetpos および std::rewind は std::ungetwc の効果を破棄します。

std::ungetwcが読み取りまたは再位置指定を挟まずに複数回呼び出された場合、失敗する可能性があります（言い換えれば、サイズ1のプッシュバックバッファは保証されますが、それより大きなバッファは実装定義です）。複数回の成功したstd::ungetwcが実行された場合、読み取り操作はstd::ungetwcの逆順でプッシュバックされたワイド文字を取得します。

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

std::ungetwcの呼び出しが成功すると、 ファイル終端ステータスフラグ feof がクリアされます。

std::ungetwcの呼び出しが成功すると（テキストストリームまたはバイナリストリームのいずれであっても）、ストリーム位置指示子は未規定の方法で変更されますが、プッシュバックされたすべてのワイド文字が読み取り操作で取得された後、ストリーム位置指示子がstd::ungetwc呼び出し前の値と等しくなることは保証されます。

パラメータ

戻り値

成功時には ch が返されます。

失敗時には WEOF が返され、指定されたストリームは変更されません。

関連項目