putwc()

Записать широкий символ в поток

Прототип:

#include <wchar.h>
wint_t putwc( wchar_t wc,
FILE *fp );

Аргументы:

wc
Широкий символ для записи.
fp
Файловый поток для вывода.

Библиотека:

libc

Описание:

Функция putwc() записывает широкий символ wc, используя преобразование (wint_t)(wchar_t), в файловый поток fp.

Возвращаемое значение:

Записанный широкий символ как (wint_t)(wchar_t). Если возникла ошибка функция возвращает WEOF, код ошибки записывается в errno.


Note: Если значение wc лежит вне допустимого диапазона, возвращается фактически записанное значение, а не wc.

Коды ошибок:

EAGAIN
Установлен флаг O_NONBLOCK для fp, но запись должна быть заблокирована.
EBADF
Файловый дескриптор fp недоступен для записи.
EFBIG
Файл превышает максимально возможный размер, лимитированный процессом размер записываемого файла или попытка записи вне максимально возможного смещения в файле.
EINTR
Операция прервана сигналом; данные не переданы.
EIO
Физическая ошибка ввода-вывода или выполнены все перечисленные условия:
EPIPE
Запись в канал (pipe) или очередь (FIFO) невозможна, поскольку ресурс закрыт; сигнал SIGPIPE был послан потоку.

Классификация:

ANSI, POSIX 1003.1

Точка остановки потока
Да
Обработчик прерываний
Нет
Обработчик сигналов
Нет
В потоке
Да

Тематические ссылки:

errno, getwc(), getwchar(), putwchar()




Предыдущий раздел: Описание API системной библиотеки