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

Guardian Native C Library Calls (t - z) vswscanf(3)
NAME
vswscanf - Converts formatted input read from a wide-character string
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 vswscanf(
const wchar_t *string,
const wchar_t *format
va_list arglist
);
PARAMETERS
string Specifies the input string to be read.
format Specifies the format conversion.
arglist Points to the argument list in which to store the converted data.
DESCRIPTION
The vswscanf() function reads character data, interprets it according to a format, and stores the
converted results into a specified argument list. The format parameter contains conversion
specifications used to interpret the input. The pointer parameter specifies where to store the inter-
preted data.
This function reads its input from the character string specified by the string parameter.
In the native environment, the vswscanf() function supports all locales.
If there are insufficient arguments in the input string for format, the behavior is undefined. If for-
mat is exhausted while arguments remain, the excess arguments are evaluated as always but are
otherwise ignored.
The format parameter can contain the following items:
• A conversion specification that directs the conversion of the next input field. Conversion
specifications start with a % (percent sign).
• Any white space character (as determined by the isspace() function) that matches 0
(zero) or more white-space characters in the input string.
• Any character except % (percent sign) or a white-space character that must match the
next character in the input string.
The input string is broken into fields based on the following:
• White space—all conversion specifications except %c, %C, and %[scanset] ignore
leading white space and consider the first trailing white-space character to delimit the
field.
527192-018 Hewlett-Packard Company 7−117