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

vsscanf(3) Guardian Native C Library Calls Reference Manual
NAME
vsscanf - Converts formatted input read from a character string
LIBRARY
G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL
G-series native OSS processes: /G/system/sysnn/zcrtlsrl
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 <stdarg.h>
#include <stdio.h>
int vsscanf(
const char *string,
const char *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 vsscanf() 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 TNS environment, the vsscanf() function supports only the C/POSIX locale. Thus, any
conversion specifications that are locale-dependent do not function correctly in locales other than
the C/POSIX locale. In the native environment, the vsscanf() 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.
7−104 Hewlett-Packard Company 527192-018