1FPUTWS(3)                  Linux Programmer's Manual                 FPUTWS(3)
2
3
4

NAME

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

SYNOPSIS

9       #include <wchar.h>
10
11       int fputws(const wchar_t *restrict ws, FILE *restrict stream);
12

DESCRIPTION

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

RETURN VALUE

22       The fputws() function returns a nonnegative integer  if  the  operation
23       was successful, or -1 to indicate an error.
24

ATTRIBUTES

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

CONFORMING TO

36       POSIX.1-2001, POSIX.1-2008, C99.
37

NOTES

39       The behavior of fputws() depends on the LC_CTYPE category of  the  cur‐
40       rent locale.
41
42       In  the  absence of additional information passed to the fopen(3) call,
43       it is reasonable to expect that fputws() will actually write the multi‐
44       byte string corresponding to the wide-character string ws.
45

SEE ALSO

47       fputwc(3), unlocked_stdio(3)
48

COLOPHON

50       This  page  is  part of release 5.12 of the Linux man-pages project.  A
51       description of the project, information about reporting bugs,  and  the
52       latest     version     of     this    page,    can    be    found    at
53       https://www.kernel.org/doc/man-pages/.
54
55
56
57GNU                               2021-03-22                         FPUTWS(3)
Impressum