This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

fputws()

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.

---

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, the process's file size limit, 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

See also:

errno, fgetws(), fputwc()

"Stream I/O functions" and "Wide-character functions" in the summary of functions chapter.