BOOTSTRAP (kutils) functions
LIBRARY ROUTINE
kscanf - scan kstdin and format the input into one or more arguments of the type specified
LIBRARY CALL
int kscanf(
const char *format,
kvalist)
INPUT
- format - the format in which to interpret the input
OUTPUT
- kvalist - variable number of arguments into which to format
the input coming from kstdin. The format string
determines the type of pointer(s) to be provided
as the argument(s).
Note that each argument must be a pointer, and that
sufficient space to accomodate the output must be
provided for strings.
RETURN VALUE
The number of arguments successfully scanned into the
input argument(s).
DESCRIPTION
This function is a replacement for the system "scanf"
call; however, kscanf() uses data transport mechanisms
to scan the input, in order to support distributed computing.
The kscanf() function reads characters from kstdin,
interprets them according to the format specified, and stores
the result(s) in the input argument(s) specified by
a variable argument list.
In addition, the kscanf() routine guarantees that the
integer returned will be the number of arguments correctly
scanned, and that scanning will never continue past the
first error. If there are insufficient arguments for the
format, the behavior is undefined; if the format is exhausted
while arguments remain, the excess arguments are ignored.
ADDITIONAL INFORMATION
none
EXAMPLES
none
SIDE EFFECTS
none
RESTRICTIONS
none
MODIFICATION
none
FILES
$BOOTSTRAP/objects/library/kutils/src/kstdio.c
SEE ALSO
kutils(3)
COPYRIGHT
Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.