fputws()

Updated: April 19, 2023

Write a wide-character string to an output stream

Synopsis:

#include <wchar.h>

int fputws( const wchar_t * ws,
            FILE * fp );

Arguments:

buf
The wide-character string you want to write.
fp
The stream you want to write the string to.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The fputws() function writes the wide-character string specified by ws to the output stream specified by fp.

Note: The terminating NUL wide character isn't written.

Returns:

A nonnegative value for success, or WEOF if an error occurs (errno is set).

Errors:

EAGAIN
The O_NONBLOCK flag is set for fp and would have been blocked by this operation.
EBADF
The stream specified by fp isn't valid for writing.
EFBIG
The file exceeds the maximum file size, or the function can't write at or beyond the offset maximum.
EINTR
A signal terminated the write operation; no data was transferred.
EIO
A physical I/O error has occurred or all of the following conditions were met:
  • The process is in the background.
  • TOSTOP is set.
  • The process is blocking/ignoring SIGTTOU.
  • The process group is orphaned.
EPIPE
Can't write to pipe or FIFO because it's closed; a SIGPIPE signal is also sent to the thread.

Classification:

ANSI, POSIX 1003.1

Safety:  
Cancellation point Yes
Interrupt handler No
Signal handler No
Thread Yes