Open System Services Library Calls Reference Manual (G06.28+, H06.05+)

OSS Library Calls (t - v) 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 native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL
H-series OSS processes: /G/system/zdllnnn/zcrtldll
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.
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.
[EINTR] The operation was interrupted by a signal that was caught, and no data was
transferred.
527187-007 Hewlett-Packard Company 7−77