Open System Services Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

OSS Library Calls (t - v) vwprintf(3)
NAME
vwprintf - Formats a variable number of parameters for output
LIBRARY
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
#include <wchar.h>
#include <stdarg.h> /* optional except for POSIX.1 */
int vwprintf(
const wchar_t *format,
va_list printarg
);
PARAMETERS
format Specifies a wide-character string that contains two types of objects:
• Plain wide-characters, which are copied to the output stream.
• Conversion specifications, each of which causes zero or more items to be
fetched from the stdarg parameter lists.
printarg Specifies the parameters to be printed.
DESCRIPTION
The vwprintf( ) function formats and writes stdarg parameter lists.
This function is the same as the printf( ) function, except that it supports wide-characters and it
is not called with a variable number of parameters. Instead, it is called with a parameter list
pointer as defined by stdarg.
See the printf(3) reference page for a desciption of the function and for information about the
conversion specifications.
RETURN VALUES
Upon successful completion, this function returns the number of bytes in the output string. Oth-
erwise, a negative value is returned.
ERRORS
The vwprintf( ) function fails if the standard output stream is unbuffered, or if the buffer needed
to be flushed and the function call caused an underlying write( ) or lseek( ) function to be
invoked. In addition, if the vwprintf( ) function fails, errno is set to one of the following values:
[EAGAIN] The O_NONBLOCK flag is set for the file descriptor underlying the output
stream and the process would be delayed in the write operation.
[EBADF] The file descriptor underlying the 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.
[EILSEQ] An invalid wide character was detected.
527187-017 Hewlett-Packard Company 7−149