putwchar(3)

1putwchar(3)                Library Functions Manual                putwchar(3)
2
3
4

NAME

6       putwchar - write a wide character to standard output
7

LIBRARY

9       Standard C library (libc, -lc)
10

SYNOPSIS

12       #include <wchar.h>
13
14       wint_t putwchar(wchar_t wc);
15

DESCRIPTION

17       The  putwchar()  function  is  the  wide-character  equivalent  of  the
18       putchar(3) function.  It writes the wide character wc  to  stdout.   If
19       ferror(stdout) becomes true, it returns WEOF.  If a wide character con‐
20       version error occurs, it sets errno to EILSEQ and returns WEOF.  Other‐
21       wise, it returns wc.
22
23       For a nonlocking counterpart, see unlocked_stdio(3).
24

RETURN VALUE

26       The putwchar() function returns wc if no error occurred, or WEOF to in‐
27       dicate an error.
28

ATTRIBUTES

30       For an  explanation  of  the  terms  used  in  this  section,  see  at‐
31       tributes(7).
32
33       ┌────────────────────────────────────────────┬───────────────┬─────────┐
34       │Interface                                   │ Attribute     │ Value   │
35       ├────────────────────────────────────────────┼───────────────┼─────────┤
36       │putwchar()                                  │ Thread safety │ MT-Safe │
37       └────────────────────────────────────────────┴───────────────┴─────────┘
38

STANDARDS

40       C11, POSIX.1-2008.
41

HISTORY

43       POSIX.1-2001, C99.
44

NOTES

46       The  behavior  of  putwchar()  depends  on the LC_CTYPE category of the
47       current locale.
48
49       It is reasonable to expect that  putwchar()  will  actually  write  the
50       multibyte sequence corresponding to the wide character wc.
51