BOOTSTRAP (kutils) functions


LIBRARY ROUTINE

kstrtok - find a token within a string

LIBRARY CALL

char *kstrtok(
   char       *istr,
   const char *sub_str)

INPUT

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.