fputws(3C)

NAME

     fputws - put wide character string on a stream

SYNOPSIS

     #include <stdio.h>
     #include <wchar.h>

     int fputws(const wchar_t *s, FILE *stream);

DESCRIPTION

     The fputws() function writes a character string  correspond-
     ing  to  the (null-terminated) wide character string pointed
     to by ws to the stream pointed to by  stream.  No  character
     corresponding to the terminating null wide-character code is
     written, nor is a NEWLINE character appended.

     The st_ctime and st_mtime fields of the file will be  marked
     for  update between the successful execution of fputws() and
     the next successful completion of a call  to  fflush(3C)  or
     fclose(3C)  on  the  same  stream  or  a  call to exit(2) or
     abort(3C).

RETURN VALUES

     Upon successful completion, fputws() returns a  non-negative
     value. Otherwise, it returns -1, sets an error indicator for
     the stream, and sets errno to indicate the error.

ERRORS

     Refer to fputwc(3C).

ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    | MT-Level                    | MT-Safe                     |
    |_____________________________|_____________________________|

SEE ALSO

     exit(2),  abort(3C),  fclose(3C),   fflush(3C),   fopen(3C),
     fputwc(3C), attributes(5)