名称

ungetc  −  入力ストリームに文字を戻す

形式

#include <stdio.h>

ungetc(c, stream)
FILE ∗stream;

解説

ungetc は、文字 c を入力ストリームに押し戻します。 この文字は、そのストリーム上で次に getc を呼び出すことにより返されます。 ungetc は c を返します。

そのストリームから既に何らかの読み込みが行われていて、 そのストリームが実際にバッファリングされていれば、 1 文字を戻すことは保証されます。 EOF を戻そうとしても受け付けられません。

fseek(3S) は、 戻されたされた文字の記憶をすべて消去します。

関連事項

getc(3S), setbuf(3S), fseek(3S)

診断

キャラクタを 押し戻せない場合、 ungetc は EOF を 返します。

NEWS-OSRelease 3.3