function::tokenize(3) [debian man page]

function::tokenize

FUNCTION:(3stap)					  A collection of standard strin					  FUNCTION:(3stap)

NAME

       function::tokenize - Return the next non-empty token in a string

SYNOPSIS

	   tokenize:string(input:string,delim:string)

ARGUMENTS

       input
	   string to tokenize. If NULL, returns the next non-empty token in the string passed in the previous call to tokenize.

       delim
	   set of characters that delimit the tokens

DESCRIPTION

       This function returns the next non-empty token in the given input string, where the tokens are delimited by characters in the delim string.
       If the input string is non-NULL, it returns the first token. If the input string is NULL, it returns the next token in the string passed in
       the previous call to tokenize. If no delimiter is found, the entire remaining input string is returned. It returns NULL when no more tokens
       are available.

SystemTap Tapset Reference					     May 2013							  FUNCTION:(3stap)

STRTOK(3)						     Linux Programmer's Manual							 STRTOK(3)

NAME

       strtok, strtok_r - extract tokens from strings

SYNOPSIS

       #include <string.h>

       char *strtok(char *s, const char *delim);

       char *strtok_r(char *s, const char *delim, char **ptrptr);

DESCRIPTION

       A `token' is a nonempty string of characters not occurring in the string delim, followed by  or by a character occurring in delim.

       The strtok() function can be used to parse the string s into tokens. The first call to strtok() should have s as its first argument. Subse-
       quent calls should have the first argument set to NULL. Each call returns a pointer to the next token, or NULL  when  no  more  tokens  are
       found.

       If  a  token ends with a delimiter, this delimiting character is overwritten with a  and a pointer to the next character is saved for the
       next call to strtok().  The delimiter string delim may be different for each call.

       The strtok_r() function is a reentrant version of the strtok() function, which instead of using its own static buffer, requires	a  pointer
       to a user allocated char*. This pointer, the ptrptr parameter, must be the same while parsing the same string.

BUGS

       Never use these functions. If you do, note that:

	      These functions modify their first argument.

	      These functions cannot be used on constant strings.

	      The identity of the delimiting character is lost.

	      The strtok() function uses a static buffer while parsing, so it's not thread safe. Use strtok_r() if this matters to you.

RETURN VALUE

       The strtok() function returns a pointer to the next token, or NULL if there are no more tokens.

CONFORMING TO

       strtok()
	      SVID 3, POSIX, BSD 4.3, ISO 9899

       strtok_r()
	      POSIX.1c

SEE ALSO

       index(3), memchr(3), rindex(3), strchr(3), strpbrk(3), strsep(3), strspn(3), strstr(3)

GNU
								    2000-02-13								 STRTOK(3)