fputws - put wide character string on stream

Syntax

#include <wchar.h> Optional #include <stdio.h> (End) int fputws(const wchar_t *ws, FILE *stream);

Description fputws() 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. The structure components st_ctime and st_mtime of the file are marked for changing between successful execution of fputws() and the next successful completion of a call to fflush() or fclose() for the same data stream or a call to exit() or abort() (see sys/stat.h). Restriction This version of the C runtime system only supports 1-byte characters as wide character codes. They are of type wchar_t (see stddef.h). (End)
Return val.	Non-negative number
		upon successful completion.
	-1	if an error occurs; e.g. because the stream is unbuffered or data in the stream’s buffer needs to be written. The error indicator for the stream is set, and errno is set to indicate the error.
Errors Notes	See fputwc(). fputws() does not append a newline character. BS2000 The following applies in the case of text files with SAM access mode and variable record length for which a maximum record length is also specified: When the specification split=no was entered for fopen(), records which are longer than the maximum record length are truncated to the maximum record length when they are written. By default or with the specification split=yes, these records are split into multiple records. If a record has precisely the maximum record length, a record of the length zero is written after it. (End)
See also	fopen(), fputwc(), stdio.h, sys/stat.h, wchar.h.