Guardian Native C Library Calls Reference Manual (G06.28+, H06.05+)

scanf(3) Guardian Native C Library Calls Reference Manual
NAME
scanf - Converts formatted input read from the standard input stream
LIBRARY
G-series native Guardian processes: $SYSTEM.SYSnn.ZCRTLSRL
G-series native OSS processes: /G/system/sysnn/zcrtlsrl
H-series native Guardian processes: $SYSTEM.ZDLLnnn.ZCRTLDLL
H-series OSS processes: /G/system/zdllnnn/zcrtldll
SYNOPSIS
#include <stdio.h>
int scanf(
const char *format
[,*pointer]...
);
PARAMETERS
format Specifies the format conversion.
pointer Points to the location to store the converted data.
DESCRIPTION
The scanf() function reads character data, interprets it according to a format, and stores the con-
verted 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 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.
6−8 Hewlett-Packard Company 527192-007