fputws - Write a wide-character string to a stream
#include <stdio.h> #include <wchar.h>
const wchar_t *wcs,
FILE *stream );
Standard C Library (libc)
Interfaces documented on this reference page conform to
industry standards as follows:
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
option 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 filesize
limit or the maximum file size.
The file is a regular file and an attempt was made
to write at or beyond the offset maximum associated
with the corresponding stream. 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. A physical
I/O error occurred. This condition is defined
starting with Issue 4 Version 2 and later revisions
of the XSH specification. 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)
[ Back ]