std:: ungetwc

定義済みヘッダー <cwchar>
std:: wint_t ungetwc ( std:: wint_t ch, std:: FILE * stream ) ;

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	-	戻すワイド文字
stream	-	ワイド文字を戻すファイルストリーム

戻り値

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

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

関連項目

ungetc	ファイルストリームに文字を戻す (関数)
fgetwc getwc	ファイルストリームからワイド文字を取得する (関数)
Cドキュメント for ungetwc