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

vfwprintf(3) Guardian Native C Library Calls Reference Manual
NAME
vfwprintf - 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 vfwprintf (
FILE *stream,
const wchar_t *format,
va_list printarg);
PARAMETERS
stream Specifies the output stream.
format Specifies a wide-character string combining literal wide-characters with conver-
sion specifications.
printarg Specifies the parameters to be printed.
DESCRIPTION
The vfwprintf() function formats and writes stdarg parameter lists. This function is the same as
the fprintf() 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.
The vfwprintf() function converts, formats, and writes its value parameters, under control of the
format parameter, to the output stream specified by its stream parameter.
The format parameter is a wide-character string that contains two types of objects:
• Literal wide-characters, which are copied to the output stream.
• Conversion specifications, each of which causes zero or more items to be fetched from
the value parameter list.
If there are not enough items for format in the value parameter list, the results are unpredictable.
If more values remain after the entire format has been processed, they are ignored.
Conversion Specifications
Each conversion specification in the format parameter has the following syntax:
• A % (percent sign).
The vfwprintf() function can handle a format string that enables the system to process
elements of the parameter list in variable order. In such a case, the normal conversion
character % (percent sign) is replaced by %digit$, where digit is a decimal number in
the range from 1 to NL_ARGMAX. Conversion is then applied to the specified argu-
ment, rather than to the next unused argument. This feature provides for the definition of
format strings in an order appropriate to specific languages. When variable ordering is
used, the * (asterisk) specification for field width in precision is replaced by %digit$.If
the variable ordering feature is used, it must be specified for all conversions.
• Zero or more flags that modify the meaning of the conversion specification. The flag
characters and their meanings are as follows:
7−74 Hewlett-Packard Company 527192-018