ungetc(3)

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

標準 C ライブラリ (libc, −lc)

#include <stdio.h>

int

ungetc(int c, FILE *stream);

解説

ungetc() 関数は、 (符号なし char に変換されている) 文字 c を stream が指 す入力ストリームに戻します。プッシュバックされた文字は、次にそのストリー ムを読んだときには (逆の順序で) 返されます。プッシュバックした文字は、そ のストリームから読み出す前に、ファイル位置検索関数 (fseek(3), fsetpos(3), または rewind(3)) のいずれかへの割り込み呼び出しが成功すると廃棄されま す。

1 文字分のプッシュバックは保証されていますが、十分なメモリがある限り、実 質的には限度なしのプッシュバックが可能です。

文字のプッシュバックに成功すると、そのストリームのファイル終了表示子をク リアします。

ungetc() 関数は、変換後にプッシュバックされたキャラクタを返すか、またはそ の操作に失敗した場合は EOF を返します。引数 c の文字値が EOF に等しい場合 は、その操作は失敗してストリームは変更されません。

fseek(3), getc(3), setvbuf(3)

ungetc() 関数は、 ISO/IEC 9899:1990 (‘‘ISO C89’’) に適合しています。

FreeBSD 10.0 June 4, 1993 FreeBSD 10.0