fputwc, putwc - write a wide character to a FILE stream
wint_t fputwc(wchar_t wc, FILE *stream);
wint_t putwc(wchar_t wc, FILE *stream);
() function is the wide-character equivalent of the
function. It writes the wide character wc
. If ferror(stream)
becomes true, it returns WEOF
If a wide-character conversion error occurs, it sets errno
and returns WEOF
. Otherwise, it returns wc
() function or macro functions identically to fputwc
It may be implemented as a macro, and may evaluate its argument more than
once. There is no reason ever to use it.
For nonlocking counterparts, see unlocked_stdio(3)
() function returns wc
if no error occurred, or
to indicate an error. In the event of an error, errno
set to indicate the cause.
Apart from the usual ones, there is
- Conversion of wc to the stream's encoding fails.
For an explanation of the terms used in this section, see attributes(7)
|fputwc (), putwc ()
POSIX.1-2001, POSIX.1-2008, C99.
The behavior of fputwc
() depends on the LC_CTYPE
category of the
In the absence of additional information passed to the fopen(3)
is reasonable to expect that fputwc
() will actually write the multibyte
sequence corresponding to the wide character wc
This page is part of release 4.10 of the Linux man-pages
description of the project, information about reporting bugs, and the latest
version of this page, can be found at