sub_str - The string containing the set of character tokens.
OUTPUT
none
RETURN VALUE
A pointer to the first token in 'istr'.
Otherwise, it returns NULL on error, or if the
token string 'sub_str' is NULL.
DESCRIPTION
This function gets the next token, or substring, from the
input string using a set of characters as delimiters.
This routine is a replacement for the system
library routine strtok(). kstrtok() searches
the input string, 'istr', for a token separator, which is
specified in the second string parameter, 'sub_str'.
Then, it returns a pointer to the remaining portion of
the input string after inserting a '\\0' at the token
separator. If it is called again with a NULL as the input
string, the routine continues to parse the previous string
passed in.
ADDITIONAL INFORMATION
none
EXAMPLES
none
SIDE EFFECTS
This routine adds '\\0's to the original string. It also
has no way to check if the input string has been freed via a
kfree_and_NULL() call between subsequent calls to kstrtok().
RESTRICTIONS
none
MODIFICATION
none
FILES
$BOOTSTRAP/objects/library/kutils/src/strings.c
SEE ALSO
kutils(3)
COPYRIGHT
Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.