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

Guardian Native C Library Calls (f) fwscanf(3)
NAME
fwscanf - Converts formatted input read from an 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>
#include <stdio.h> /* optional except for POSIX.1 */
int fwscanf(
FILE *stream,
const wchar_t *format
[,*pointer]...
);
PARAMETERS
stream Specifies the input stream.
format Specifies the format conversion.
pointer Points to the location to store the converted data.
DESCRIPTION
The fwscanf() 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 the stream parameter.
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.
527192-018 Hewlett-Packard Company 2−169