ИМЯ

       ungetwc - отправка широкого символа обратно в поток FILE

LIBRARY

       Standard C library (libc, -lc)

СИНТАКСИС

       #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 текущей локали.

СМ. ТАКЖЕ

       fgetwc(3)

ПЕРЕВОД

       Русский    перевод    этой    страницы    руководства    был    сделан   Azamat   Hackimov
       <azamat.hackimov@gmail.com>,   Dmitriy    Ovchinnikov    <dmitriyxt5@gmail.com>,    Dmitry
       Bolkhovskikh  <d20052005@yandex.ru>,  Katrin Kutepova <blackkatelv@gmail.com>, Yuri Kozlov
       <yuray@komyakino.ru> и Иван Павлов <pavia00@gmail.com>

       Этот  перевод  является  бесплатной  документацией;  прочитайте  Стандартную  общественную
       лицензию GNU версии 3 ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ или более позднюю, чтобы
       узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.

       Если вы обнаружите ошибки в переводе  этой  страницы  руководства,  пожалуйста,  отправьте
       электронное письмо на ⟨man-pages-ru-talks@lists.sourceforge.net⟩.