BOOTSTRAP (kutils) functions
LIBRARY ROUTINE
kfscanf - scan file input and format it into one or more arguments of the type specified
LIBRARY CALL
int kfscanf(
kfile *file,
const char *format,
kvalist)
INPUT
- file - stream to open input file
- format - the format in which to interpret the input
OUTPUT
- kvalist - variable number of arguments into which to format
the input from the file stream. 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 "fscanf"
call; however, kfscanf() uses data transport mechanisms
to scan the input, in order to support distributed computing.
The kfscanf() function reads characters from an input
transport, interprets them according to the format specified,
and stores the result in the input argument(s) specified
by the variable argument list.
In addition, the kfscanf() routine guarantees that the
integer returned will be the number of fields 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.