ungetwc(3) Library Functions Manual ungetwc(3)

ИМЯ

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

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

СТАНДАРТЫ

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>

Этот перевод является бесплатной документацией; прочитайте Стандартную общественную лицензию GNU версии 3 или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.

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

20 июля 2023 г. Linux man-pages 6.05.01