DragonFly On-Line Manual Pages


PUTWC(3)	      DragonFly Library Functions Manual	      PUTWC(3)

NAME

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

LIBRARY

Standard C Library (libc, -lc)

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 ISO/IEC 9899:1999 (``ISO C99''). DragonFly 3.9 December 25, 2013 DragonFly 3.9