fputws(S)

putws -- put a wchar_t string on a stream

Synopsis

   #include <stdio.h>
   #include <wchar.h>
   
   int fputws(const wchar_t *ws, FILE *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.

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 or fclose on the same stream or a call to exit or abort.

Return value

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

Errors

See fputwc(S).

Usage

The fputws function does not append a newline character.

References

ferror(S), fopen(S), fprintf(S), fread(S), intro(S), Intro(S), putwc(S), putws(S), widec(S)