BOOTSTRAP (kutils) functions
LIBRARY ROUTINE
ksscanf - scan input string and format it into one or more arguments of the type specified.
LIBRARY CALL
int ksscanf(
const char *string,
const char *format,
kvalist)
INPUT
- string - the input string to format
- format - the format in which to interpret the input
OUTPUT
- kvalist - variable number of arguments into which to format the
input string. 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 characters successfully formatted into the
input argument(s).
DESCRIPTION
This function is a replacement for the system "sscanf"
call; however, ksscanf() uses data transport mechanisms
to scan the input, in order to support distributed computing.
The ksscanf() function reads character data input, interprets
them according to the format specified, and stores the result
in the input arguments(s) specified by the variable argument
list. In addition, the ksscanf() 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.