fputws - Writes a wide-character string to a stream
Standard C Library (libc.so, libc.a)
Application developers may want to specify an #include statement for <stdio.h> before the one for <wchar.h> if programs are being developed for multiple platforms. The additional #include statement is not required on Tru64 UNIX systems or by ISO or X/Open standards, but may be required on other vendors' systems that conform to these standards.
Interfaces documented on this reference page conform to industry standards as follows:
fputws(): XPG4, XPG4-UNIX
Refer to the standards(5) reference page for more information about industry standards and associated tags.
Points to a wide-character string to be written to output. Points to the FILE structure of an open file.
The fputws() function reads the wchar_t string pointed to by the wcs parameter, converts each wide character to a multibyte character, and writes the result to the output stream pointed to by the stream parameter. The function does not append a newline or a terminating null character to the result.
The fputws() function parallels the fputs() function.
The st_ctime and st_mtime fields of the file are marked for update between the successful execution of the fputws() function and the next successful completion of a call to the fflush() or fclose() function on the same stream, or a call to the exit() or abort() function.
On successful completion, the fputws() function returns a non-negative number to indicate the number of bytes written to the output stream. Otherwise, the function returns -1, sets the error indicator for the stream, and sets errno to indicate the error.
If any of the following conditions occur, the fputws() function sets errno to the corresponding value: The O_NONBLOCK flag is set for the file descriptor underlying stream and the process would be delayed in the write operation. The file descriptor underlying stream is not a valid file descriptor open for writing. An attempt was made to write to a file that exceeds the process's file-size limit or the maximum file size. The write operation was interrupted by a signal that was caught, and no data was transferred. One of the following errors was encountered: The process is a member of a background process group attempting to write to its controlling terminal and TOSTOP is set; the process is neither ignoring nor blocking SIGTTOU and the process group of the process is orphaned. [XPG4-UNIX] A physical I/O error occurred. A wide character read from wcs does not correspond to a valid multibyte character in the current locale. There was no free space remaining on the device containing the file. An attempt was made to write to a pipe or FIFO that is not open for reading by any process. A SIGPIPE signal will also be sent to the process.
Functions: fgetws(3), gets(3), wcstombs(3), printf(3), putc(3), puts(3), putwc(3), wprintf(3)
Standards: standards(5) delim off