ungetwc()

Вернуть широкий символ во входной поток

Прототип:

#include <wchar.h>
wint_t ungetwc( wint_t wc,
FILE *fp );

Аргументы:

c
Широкий символ, который требуется вернуть.
fp
Поток, в который требуется вернуть символ.

Библиотека:

libc

Описание:

Функция ungetwc() возвращает широкий символ, определённый wc на вход потоку, на который указывает fp.

Символ будет возвращён в следующий раз, когда будет происходить чтение из потока. Возвращёный символ будет отвергнут при использовании fflush() или функций позиционирования в файле ( fseek(), fsetpos(), или rewind()) перед следующей операцией чтения.

Гарантируется возвращение только одного символа (самого последнего).

Функция ungetwc() удаляет индикатор конца файла, если значение wc не WEOF.

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

Возвращёный символ.

Коды ошибок:

EILSEQ
Недопустимая последовательность символов или широкий символ.

Классификация:

ANSI, POSIX 1003.1

Точка остановки потока
Да
Обработчик прерываний
Нет
Обработчик сигналов
Нет
В потоке
Да

Тематические ссылки:

fopen(), getwc(), ungetc()




Предыдущий раздел: Описание API системной библиотеки