fputwc, putwc

Определено в заголовке `<wchar.h>`
wint_t fputwc( wchar_t ch, FILE* stream );	(1)	(с C95)
wint_t putwc( wchar_t ch, FILE* stream );	(2)	(с C95)

Записывает широкий символ ch в заданный поток вывода stream.

2) Может быть реализовано как макрос и может вычислять stream более одного раза.

Параметры

ch	-	широкий символ для записи
stream	-	поток вывода

Значение возврата

Возвращает копию ch при успешном выполнении.

В случае неудачи возвращает WEOF и устанавливает индикатор ошибки (см. ferror()) в stream.

Если произошла ошибка кодирования, дополнительно устанавливает errno в значение EILSEQ.

Пример

#include <errno.h>
#include <locale.h>
#include <stdio.h>
#include <stdlib.h>
#include <wchar.h>
 
int main(void)
{
    setlocale(LC_ALL, "en_US.utf8");
 
    errno = 0;
    if (fputwc(L'🍌', stdout) == WEOF)
    {
        if (errno == EILSEQ)
            puts("Encoding error in fputwc.");
        else
            puts("I/O error in fputwc.");
        return EXIT_FAILURE;
    }
}

Возможный вывод:

🍌

Ссылки

Стандарт C23 (ISO/IEC 9899:2023):

7.31.3.3 Функция fputwc (стр. 430)
7.31.3.8 Функция putwc (стр. 431-432)

Стандарт C17 (ISO/IEC 9899:2018):

7.29.3.3 Функция fputwc (стр. 308)
7.29.3.8 Функция putwc (стр. 310)

Стандарт C11 (ISO/IEC 9899:2011):

7.29.3.3 Функция fputwc (стр. 422-423)
7.29.3.8 Функция putwc (стр. 424)

Стандарт C99 (ISO/IEC 9899:1999):

7.24.3.3 Функция fputwc (стр. 368)
7.24.3.8 Функция putwc (стр. 370)

См. также

fputcputc	записывает символ в поток файла (функция)
fputws (C95)	записывает широкую строку в поток файла (функция)
fgetwcgetwc (C95)	считывает широкий символ из потока файла (функция)
Документация C++ для `fputwc`

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/c/io/fputwc