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(5) for descriptions of the following attributes:

ATTRIBUTE TYPE ATTRIBUTE VALUE Interface Stability Committed MT-Level MT-Safe Standard See standards(5).

See also

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