PUTWC(3)

NAME
fputwc, fputwc_l, putwc, putwc_l, putwchar, putwchar_l - output a wide character to a stream

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
The fputwc() 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 isoC-99.