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

Guardian Native C Library Calls (t - z) vprintf(3)
NAME
vprintf - Formats a variable number of parameters for output
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
#include <stdarg.h>
#include <stdio.h>
int vprintf(
const char *format,
va_list printarg
);
PARAMETERS
format Specifies a character string that contains two types of objects:
• Plain 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 vprintf() function formats and writes stdarg parameter lists.
This function is the same as the printf( ) function, except that it is not called with a variable
number of parameters. Instead, it is called with a parameter list pointer as defined by stdarg.
For a description of the conversion specifications supported for this function, see the printf(3)
reference page.
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 vprintf() 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 vprintf() 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.
527192-018 Hewlett-Packard Company 7−87