NAME
fputwc, fputwc_l,
putwc, putwc_l,
putwchar, putwchar_l
— output a wide character to a
stream
LIBRARY
library “libc”
SYNOPSIS
#include <stdio.h>
#include <wchar.h>
wint_t
fputwc(wchar_t
wc, FILE
*stream);
wint_t
putwc(wchar_t
wc, FILE
*stream);
wint_t
putwchar(wchar_t
wc);
#include
<xlocale.h>
wint_t
fputwc_l(wchar_t
wc, FILE *stream,
locale_t locale);
wint_t
putwc_l(wchar_t
wc, FILE *stream,
locale_t locale);
wint_t
putwchar_l(wchar_t
wc, locale_t
locale);
DESCRIPTION
Thefputwc()
and fputwc_l() functions write the wide character
wc to the output stream pointed to by
stream.
The
putwc() and
putwc_l()
functions act essentially identically to fputwc()
and fputwc_l().
The
putwchar()
and
putwchar_l()
functions are identical to putwc() and
putwc_l() with an output stream of
stdout.
The
fputwc_l(),
putwc_l(),
and putwchar_l() functions take an explicit
locale argument, whereas the
fputwc(), putwc(), and
putwchar() functions use the current global or
per-thread locale.
RETURN VALUES
The fputwc(),
fputwc_l(), putwc(),
putwc_l(), putwchar(), and
putwchar_l() functions return the wide character
written. If an error occurs, the value WEOF is
returned.
SEE ALSO
ferror(3), fopen(3), getwc(3), putc(3), stdio(3), xlocale(3)
STANDARDS
The fputwc(),
putwc(), and putwchar()
functions conform to ISO/IEC 9899:1999
(“ISO C99”).