FPUTWS(3C) Standard C Library Functions FPUTWS(3C)

NAME


fputws - put wide character string on a stream

SYNOPSIS


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

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


DESCRIPTION


The fputws() function writes a character string corresponding 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(7) for descriptions of the following attributes:


+--------------------+-----------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Standard |
+--------------------+-----------------+
|MT-Level | MT-Safe |
+--------------------+-----------------+

SEE ALSO


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

illumos November 1, 2003 FPUTWS(3C)