putwc() -- write wide character to stream

SYNOPSIS

#include <stdio.h>

#include <wchar.h>

wint_t putwc(wchar_t wc, FILE *stream);

DESCRIPTION

The putwc() function writes a wide character to output stream stream and advances the file position accordingly. This function is equivalent to fputwc().

If stream is open in binary mode, then wc is written as a UNICODE character. Otherwise wc is translated to the corresponding multibyte character on output.

PARAMETERS

wc: Is the value of the wide character to write to stream.
stream: Points to the output stream.

RETURN VALUES

If successful, the putwc() function returns zero. On error, it returns non-zero and sets errno to one of the following values:

EACCES: Another process has the file locked.
EBADF: The value stream is not a pointer to a valid stream opened for writing.
EFBIG: The file is a regular file and an attempt was made to write at or beyond the offset maximum associated with the corresponding stream.
EINTR: A signal interrupted the call.
EIO: An output error occurred.
ENOMEM: Memory could not be allocated for internal buffers.
ENOSPC: An attempt was made to write to a full disk.
ENXIO: A device error occurred.
EPIPE: An attempt was made to write to a closed pipe.

CONFORMANCE

UNIX 98.

MULTITHREAD SAFETY LEVEL

MT-Safe.

PORTING ISSUES

If stream is open in text mode, then linefeed is translated into carriage-return linefeed on output. No such translation occurs for files open in binary mode.

AVAILABILITY

MKS Toolkit for Professional Developers
MKS Toolkit for Enterprise Developers
MKS Toolkit for Enterprise Developers 64-Bit Edition

putwc()
write wide character to stream

Function