ungetwc

＜ungetwc＞
概要	ワイド文字を1文字ストリームに戻す。
ヘッダ	`#include <stdio.h> #include <wchar.h>`
I/F	`wint_t ungetwc(wint_t c, FILE *stream);`
戻り値	押し戻されたワイド文字。操作が失敗した場合はWEOF。
詳細	ungetwc関数は、ワイド文字cをstreamが指す入力ストリームに押し戻す。その後の、そのストリームに対する読み取り時には、押し戻されたワイド文字が逆順で返される。押し戻したワイド文字を読み取る前にファイル位置付け関数(fseek、fsetpos、rewind)が正常に呼び出されると、押し戻されていたワイド文字は捨てられる。ungetwc関数は、ストリームに対応している外部記憶を変更しない。また、どの処理系でも1ワイド文字の押戻しを保証する。ストリームに対する読取りやファイル位置付けを行わずに、連続してungetwc関数を何度もコールすると、ungetwc関数は失敗する可能性がある。cの値がWEOFであるとき、ungetwc関数は失敗する。そのとき、入力ストリームの変更はない。ungetwc関数の呼出しが成功すると、そのストリームのファイル終了表示子はクリアされる。押し戻された文字をすべて読み取った後、又は捨てた後のストリームのファイル位置表示子の値は、押し戻される前と同じである。ungetwc関数の呼出し成功後から押し戻された文字がすべて読み取られるか、捨てられるまでの間は、ストリームでのファイル位置表示子の値は未規定である。