fputws(3)

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

NAME

6       fputws - write a wide-character string to a FILE stream
7

LIBRARY

9       Standard C library (libc, -lc)
10

SYNOPSIS

12       #include <wchar.h>
13
14       int fputws(const wchar_t *restrict ws, FILE *restrict stream);
15

DESCRIPTION

17       The  fputws() function is the wide-character equivalent of the fputs(3)
18       function.  It writes the wide-character string starting at  ws,  up  to
19       but  not  including  the  terminating  null  wide character (L'\0'), to
20       stream.
21
22       For a nonlocking counterpart, see unlocked_stdio(3).
23

RETURN VALUE

25       The fputws() function returns a nonnegative integer  if  the  operation
26       was successful, or -1 to indicate an error.
27

ATTRIBUTES

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

STANDARDS

39       C11, POSIX.1-2008.
40

HISTORY

42       POSIX.1-2001, C99.
43

NOTES

45       The behavior of fputws() depends on the LC_CTYPE category of  the  cur‐
46       rent locale.
47
48       In  the  absence of additional information passed to the fopen(3) call,
49       it is reasonable to expect that fputws() will actually write the multi‐
50       byte string corresponding to the wide-character string ws.
51