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 системной библиотеки