putwc(3C) putwc(3C)
NAME
putwc(), putwchar(), fputwc() - put a wide character on a stream file
SYNOPSIS
_INCLUDE__STDC_A1_SOURCE only
Obsolescent Interfaces
Remarks:
These functions are compliant with the XPG4 Worldwide Portability Interface wide-character I/O functions. They parallel the 8-bit charac-
ter I/O functions defined in putc(3S).
DESCRIPTION
Writes the character corresponding to the wide character
wc onto the output stream at the position where the file pointer is pointing. is defined as and are defined both as macros
and as functions.
Behaves like but is a function rather than a macro, and can therefore be used as an argument.
Output streams, with the exception of the standard error stream are by default buffered if the output refers to a file and line-buffered if
the output refers to a terminal. The standard error output stream, is by default unbuffered, but use of (see fopen(3S)) causes it to
become buffered or line-buffered. or (see setbuf(3S)) can be used to change the stream's buffering strategy.
Definitions for these functions, the type wint_t and the value WEOF are provided in the header.
Obsolescent Interfaces
and put a wide character on a stream file.
APPLICATION USAGE
To use the prototype, the flag must be passed as a compiler option or defined as a macro in source files.
After or is applied to a stream, the stream becomes byte-oriented (see orientation(5)).
EXTERNAL INFLUENCES
Locale
The category determines how wide character conversions are done.
International Code Set Support
Single- and multi-byte character code sets are supported.
RETURN VALUE
On success, and each return the wide character corresponding to the value they have written. On failure, they return the constant set the
error indicator for the stream, and set to indicate the error.
ERRORS
and fail if either the stream is unbuffered, or stream's buffer needed to be flushed causing an underlying call to be invoked, and:
[EAGAIN] The flag is set for the file descriptor underlying stream and the process would be delayed in the write operation.
[EBADF] The file descriptor underlying stream is not a valid file descriptor open for writing.
[EFBIG] An attempt was made to write to a file that exceeds the process's file size limit or the maximum file size (see
ulimit(2)).
[EINTR] A signal was caught during the system call.
[EIO] A physical I/O error has occurred, or the process is in a background process group and is attempting to write to its
controlling terminal, is set, the process is neither ignoring nor blocking the signal, and the process group of the
process is orphaned.
[ENOSPC] There was no free space remaining on the device containing the file.
[EPIPE] An attempt is made to write to a pipe or FIFO that is not open for reading by any process. A signal is also sent to
the process.
[EILSEQ] The wide character wc does not correspond to a valid character.
Additional values can be set by the underlying function (see write(2)).
WARNINGS
Line buffering may cause confusion or malfunctioning of programs that use wide character I/O routines but use themselves to read from stan-
dard input. When a large amount of computation is done after printing part of a line on an output terminal, it is necessary to (see
fclose(3S)) the standard output before beginning the computation.
and are obsolescent interfaces supported only for compatibility with existing DCE applications. New multithreaded applications should use
and
AUTHOR
was developed by OSF and HP.
SEE ALSO
fclose(3S), ferror(3S), flockfile(3S), fopen(3S), getwc(3C), fread(3S), printf(3S), putws(3C), setbuf(3S), orientation(5),
thread_safety(5).
STANDARDS CONFORMANCE
putwc(3C)