ungetwc - отправка широкого символа обратно в поток FILE
ungetwc(3)
отправка широкого символа обратно в поток FILE
ОБЗОР
#include <wchar.h>
wint_t ungetwc(wint_t wc, FILE *stream);
ОПИСАНИЕ
Функция
ungetwc() — это эквивалент функции
ungetc(3) для широких
символов. Она отправляет широкий символ обратно в поток
stream и
возвращает его.
Если wc равно WEOF, то возвращается WEOF. Если wc — это
некорректный широкий символ, то значение errno устанавливается в
EILSEQ и возвращается WEOF.
Если wc — это корректный широкий символ, то он отправляется обратно в
поток и, таким образом, становится доступным для последующих операций чтения
широких символов. Индикатор позиции в файле уменьшается на единицу или
более. Индикатор конца файла очищается. Непосредственный носитель файла при
этой операции не задействуется.
Замечание: wc не должен быть последним широким символом в потоке; он
может быть любым другим корректным широким символом.
Если реализация поддерживает несколько последовательных операций возвращения
подряд, то возвращённые широкие символы будут прочитаны в обратном порядке;
однако гарантированно работает только однократный возврат.
ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ
При успешном выполнении функция
ungetwc возвращает
wc или
WEOF в
случае ошибки.
АТРИБУТЫ
Описание терминов данного раздела смотрите в
attributes(7).
Интерфейс Атрибут Значение
ungetwc()
безвредность в потоках: безвредно (MT-Safe)
СООТВЕТСТВИЕ СТАНДАРТАМ
POSIX.1-2001, POSIX.1-2008, C99.
ЗАМЕЧАНИЯ
Поведение
ungetwc() зависит от категории
LC_CTYPE текущей локали.
