Open System Services Library Calls Reference Manual (G06.29+, H06.08+, J06.03+)

OSS 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.
527187-017 Hewlett-Packard Company 6−207