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 |
POSIX.1-2001, POSIX.1-2008, C99.
Поведение
ungetwc() зависит
от
категории
LC_CTYPE текущей
локали.
fgetwc(3)
Русский
перевод
этой
страницы
руководства
был сделан
Azamat Hackimov <
[email protected]>, Dmitriy Ovchinnikov
<
[email protected]>, Dmitry Bolkhovskikh <
[email protected]>,
Katrin Kutepova <
[email protected]>, Yuri Kozlov
<
[email protected]> и Иван
Павлов <
[email protected]>
Этот
перевод
является
бесплатной
документацией;
прочитайте
Стандартную
общественную
лицензию GNU
версии 3
или более
позднюю,
чтобы
узнать об
условиях
авторского
права. Мы не
несем
НИКАКОЙ
ОТВЕТСТВЕННОСТИ.
Если вы
обнаружите
ошибки в
переводе
этой
страницы
руководства,
пожалуйста,
отправьте
электронное
письмо на
[email protected]