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

Guardian Native C Library Calls (t - z) wscanf(3)
NAME
wscanf - Converts formatted input read from the standard input stream
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>
int wscanf(
const wchar_t *format
[,*pointer]...
);
PARAMETERS
format Specifies the format conversion.
pointer Points to the location to store the converted data.
DESCRIPTION
The wscanf() function reads wide-character data, interprets it according to a format, and stores
the converted results into a specified memory location. The format parameter contains conver-
sion specifications used to interpret the input. The pointer parameter specifies where to store the
interpreted data.
This function reads its input from stdin.
If there are insufficient arguments in the input stream for format, the behavior is undefined. If
format 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 stream.
• Any character except % (percent sign) or a white-space character that must match the
next character in the input stream.
The input stream 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.
• Invalid character—if the input stream contains a character that is not allowed, this
invalid character delimits the field and is considered the first character of the next field.
• Maximum width—if the conversion specification includes a maximum width and the
field is not terminated by white space or an invalid character, then when that maximum
width is reached in the input stream, the field is terminated.
527192-018 Hewlett-Packard Company 7−205