1FPUTWS(P)                  POSIX Programmer's Manual                 FPUTWS(P)
2
3
4

NAME

6       fputws - put a wide-character string on a stream
7

SYNOPSIS

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

DESCRIPTION

16       The  fputws()  function shall write a character string corresponding to
17       the (null-terminated) wide-character string pointed to  by  ws  to  the
18       stream  pointed  to by stream. No character corresponding to the termi‐
19       nating null wide-character code shall be written.
20
21       The st_ctime and st_mtime fields of the file shall be marked for update
22       between  the  successful  execution of fputws() and the next successful
23       completion of a call to fflush() or fclose() on the same  stream  or  a
24       call to exit() or abort().
25

RETURN VALUE

27       Upon  successful  completion, fputws() shall return a non-negative num‐
28       ber. Otherwise, it shall return -1, set  an  error  indicator  for  the
29       stream,    and set errno to indicate the error.
30

ERRORS

32       Refer to fputwc() .
33
34       The following sections are informative.
35

EXAMPLES

37       None.
38

APPLICATION USAGE

40       The fputws() function does not append a <newline>.
41

RATIONALE

43       None.
44

FUTURE DIRECTIONS

46       None.
47

SEE ALSO

49       fopen()   ,   the  Base  Definitions  volume  of  IEEE Std 1003.1-2001,
50       <stdio.h>, <wchar.h>
51

53       Portions of this text are reprinted and reproduced in  electronic  form
54       from IEEE Std 1003.1, 2003 Edition, Standard for Information Technology
55       -- Portable Operating System Interface (POSIX),  The  Open  Group  Base
56       Specifications  Issue  6,  Copyright  (C) 2001-2003 by the Institute of
57       Electrical and Electronics Engineers, Inc and The Open  Group.  In  the
58       event of any discrepancy between this version and the original IEEE and
59       The Open Group Standard, the original IEEE and The Open Group  Standard
60       is  the  referee document. The original Standard can be obtained online
61       at http://www.opengroup.org/unix/online.html .
62
63
64
65IEEE/The Open Group                  2003                            FPUTWS(P)
Impressum