Open System Services Library Calls Reference Manual (G06.27+, H06.04+)

vprintf(3) OSS Library Calls Reference Manual
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 to a file that exceeds the process’s file size limit or
the maximum file size.
[EILSEQ] An invalid wide character was detected.
[EINTR] The operation was interrupted by a signal that was caught, and no data was
transferred.
7−72 Hewlett-Packard Company 527187-004