ungetwc(3) | Library Functions Manual | ungetwc(3) |
ИМЯ
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 текущей локали.
СМОТРИТЕ ТАКЖЕ
ПЕРЕВОД
Русский перевод этой страницы руководства разработал(и) 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 (GNU General Public License - GPL, https://www.gnu.org/licenses/gpl-3.0.html версии 3 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.
Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом разработчику(ам) по его(их) адресу(ам) электронной почты или по адресу списка рассылки русских переводчиков.
2 мая 2024 г. | Справочные страницы Linux 6.9.1 |