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
46       current 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
50       multibyte string corresponding to the wide-character string ws.
51