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

Guardian Native C Library Calls (s) swscanf(3)
NAME
swscanf - 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 swscanf(
const wchar_t *string,
const wchar_t *format
[,*pointer]...
);
PARAMETERS
string Specifies the input string to be read.
format Specifies the format conversion.
pointer Points to the location to store the converted data.
DESCRIPTION
The swscanf() function reads character data, interprets it according to a format, and stores the
converted results into a specified memory location. 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 swscanf() 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 6−155