Linux repositories inspector
GNU
2015-08-08

man-pages-ru

Russian man pages from the Linux Documentation Project

manpages-dev

Manual pages about using GNU/Linux for development

man-pages

Linux kernel and C library user-space interface documentation

ИМЯ

ungetwc - отправка широкого символа обратно в поток 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 текущей локали.

СМОТРИТЕ ТАКЖЕ

REFERENCED BY

⇧ Top