NAME¶
putwchar - write a wide character to standard output
SYNOPSIS¶
#include <wchar.h>
wint_t putwchar(wchar_t wc);
DESCRIPTION¶
The
putwchar() function is the wide-character equivalent of the
putchar(3) function. It writes the wide character
wc to
stdout. If
ferror(stdout) becomes true, it returns
WEOF.
If a wide character conversion error occurs, it sets
errno to
EILSEQ and returns
WEOF. Otherwise, it returns
wc.
For a nonlocking counterpart, see
unlocked_stdio(3).
RETURN VALUE¶
The
putwchar() function returns
wc if no error occurred, or
WEOF to indicate an error.
ATTRIBUTES¶
For an explanation of the terms used in this section, see
attributes(7).
Interface |
Attribute |
Value |
putwchar () |
Thread safety |
MT-Safe |
POSIX.1-2001, POSIX.1-2008, C99.
NOTES¶
The behavior of
putwchar() depends on the
LC_CTYPE category of the
current locale.
It is reasonable to expect that
putwchar() will actually write the
multibyte sequence corresponding to the wide character
wc.
SEE ALSO¶
fputwc(3),
unlocked_stdio(3)
COLOPHON¶
This page is part of release 4.10 of the Linux
man-pages project. A
description of the project, information about reporting bugs, and the latest
version of this page, can be found at
https://www.kernel.org/doc/man-pages/.