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

OUTPUT

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.