Guardian Native C Library Calls Reference Manual (G06.28+, H06.05+)

putwchar(3) Guardian Native C Library Calls Reference Manual
NAME
putwchar - Writes a wide character to the standard output stream
LIBRARY
G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL
G-series native OSS processes: /G/system/sysnn/zcrtlsrl
H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL
H-series OSS processes: /G/system/zdllnnn/zcrtldll
SYNOPSIS
#include <wchar.h>
wint_t putwchar(
wint_t c);
PARAMETERS
c Specifies the wide character to be written.
DESCRIPTION
The putwchar( ) function converts the wchar_t specified by the c parameter to its equivalent
multibyte character and then writes the multibyte character to the standard output.
With the exception of stderr, output streams are, by default, buffered if they refer to files, or line
buffered if they refer to terminals. The standard error output stream, stderr, is unbuffered by
default, but using the freopen( ) function causes it to become buffered or line buffered. Use the
setbuf() function to change the stream’s buffering strategy.
RETURN VALUES
Upon successful completion, this function returns the value written. If this function fails, it
returns the constant WEOF.
ERRORS
If any of the following conditions occur, the putwchar() function sets errno to the correspond-
ing value.
[EAGAIN] The O_NONBLOCK flag is set for the file descriptor underlying the standard
output stream and the process would be delayed in the write operation.
[EBADF] The file descriptor underlying the standard output stream is not a valid file
descriptor open for writing.
[EFBIG] An attempt was made to write at or beyond the file offset maximum. |
[EIO] The implementation supports job control; the process is a member of a back-
ground process group attempting to write to its controlling terminal; TOSTOP is
set; the process is neither ignoring nor blocking SIGTTOU; and the process
group of the process is orphaned.
[ENOMEM] Insufficient storage space is available.
[ENOSPC] There was no free space remaining on the device containing the file.
[ENXIO] A request was made of a non-existent device, or the request was outside the
capabilities of the device.
[EPIPE] 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.
5−48 Hewlett-Packard Company 527192-007