ungetwc

Определено в заголовке <wchar.h>
wint_t ungetwc ( wint_t ch, FILE * stream ) ;		(начиная с C95)

Если ch не равно WEOF , помещает широкий символ ch во входной буфер, связанный с потоком stream таким образом, что последующая операция чтения из stream извлечёт этот широкий символ. Внешнее устройство, связанное с потоком, не изменяется.

Операции перепозиционирования потока fseek , fsetpos и rewind отменяют эффекты ungetwc .

Если ungetwc вызывается более одного раза без промежуточного чтения или изменения позиции, это может завершиться неудачей (другими словами, гарантируется буфер возврата размером 1, но любой буфер большего размера определяется реализацией). Если было выполнено несколько успешных вызовов ungetwc , операции чтения извлекают возвращённые широкие символы в порядке, обратном вызовам ungetwc

Если ch равно WEOF , операция завершается неудачно и поток не изменяется.

Успешный вызов ungetwc сбрасывает флаг состояния конца файла feof .

Успешный вызов ungetwc для потока (текстового или бинарного) изменяет индикатор позиции потока неопределённым образом, но гарантирует, что после извлечения всех возвращённых обратно широких символов операцией чтения, индикатор позиции потока будет равен его значению до ungetwc .

Содержание 1 Параметры 2 Возвращаемое значение 3 Ссылки 4 Смотри также

Параметры

ch	-	широкий символ для возврата
stream	-	файловый поток для возврата широкого символа

Возвращаемое значение

При успешном выполнении ch возвращается.

При неудаче WEOF возвращается, а заданный поток остается неизменным.

Ссылки