Guardian Native C Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

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 and J-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL
32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zcrtldll
64-bit H-series and J-series OSS processes: /G/system/zdllnnn/ycrtldll
SYNOPSIS For TNS/E Target Compilations on H06.09 and Later RVUs
This version of the function applies to TNS/E target compilations on H06.09 and later H-series
RVUs.
#include <wchar.h>
wint_t putwchar(
wchar_t c);
SYNOPSIS For Other RVUs
This version of the function applies to TNS/R target compilations and to TNS/E target compila-
tions on H06.08 and earlier H-series RVUs.
#include <wchar.h>
wint_t putwchar(
wint_t c);
PARAMETERS
c Specifies the wide character to be written. The data type of this parameter
depends on the target compilation and the RVU the system is running:
• If the target is TNS/R or if the target is TNS/E and the system is running
H06.08 or an earlier H-series RVU, the data type of this parameter can
be either wint_t or wchar_t.
• If the target is TNS/E and the system is running H06.09 or a later H-
series RVU, the data type of this parameter must be wchar_t. If you
have an existing object file compiled from source text that specifies a
value of type wint_t for this parameter, you can continue to use the
object file. However, if you recompile the same source text, the com-
piler converts the wint_t value to a wchar_t value and issues a warning
message.
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.
5−76 Hewlett-Packard Company 527192-018