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.

---

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

---

Коды ошибок:

EAGAIN

Установлен флаг O_NONBLOCK для fp, но запись должна быть заблокирована.

EBADF

Файловый дескриптор fp недоступен для записи.

EFBIG

Файл превышает максимально возможный размер, лимитированный процессом размер записываемого файла или попытка записи вне максимально возможного смещения в файле.

EINTR

Операция прервана сигналом; данные не переданы.

EIO

Физическая ошибка ввода-вывода или выполнены все перечисленные условия:

• процесс является фоновым.
• установлен флаг TOSTOP.
• процесс блокирует/игнорирует SIGTTOU.
• группа процессов потеряна.

EPIPE

Запись в канал (pipe) или очередь (FIFO) невозможна, поскольку ресурс закрыт; сигнал SIGPIPE был послан потоку.

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

ANSI, POSIX 1003.1

Безопасность использования

Точка остановки потока

Да

Обработчик прерываний

Нет

Обработчик сигналов

Нет

В потоке

Да

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

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

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