Guardian Native C Library Calls Reference Manual (G06.28+, H06.05+)

vprintf(3) Guardian Native C 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 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.
7−54 Hewlett-Packard Company 527192-007