НАИМЕНОВАНИЕ

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

БИБЛИОТЕКА

       Стандартная библиотека языка C (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  │
       └─────────────────────────────────────────────────────────────────────┴──────────────────────┴──────────┘

СТАНДАРТЫ

       C11, POSIX.1-2008.

ИСТОРИЯ

       POSIX.1-2001, 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> и Kirill
       Rekhov <krekhov.dev@gmail.com>

       Этот перевод является свободной программной документацией; он распространяется на условиях  общедоступной
       лицензии  GNU  (GNU  General Public License - GPL, https://www.gnu.org/licenses/gpl-3.0.html версии 3 или
       более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.

       Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите  об  этом
       разработчику(ам)   по   его(их)  адресу(ам)  электронной  почты  или  по  адресу  списка рассылки русских
       переводчиков.

Справочные страницы Linux 6.9.1                   2 мая 2024 г.                                       ungetwc(3)