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)

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

NAME

       wcstok - split wide-character string into tokens

SYNOPSIS

       #include <wchar.h>

       wchar_t *wcstok(wchar_t *wcs, const wchar_t *delim, wchar_t **ptr);

DESCRIPTION

       The  wcstok function is the wide-character equivalent of the strtok function, with an added argument to make it multithread-safe. It can be
       used to split a wide-character string wcs into tokens, where a token is defined as a substring  not  containing	any  wide-characters  from
       delim.

       The  search  starts  at	wcs,  if  wcs  is not NULL, or at *ptr, if wcs is NULL. First, any delimiter wide-characters are skipped, i.e. the
       pointer is advanced beyond any wide-characters which occur in delim.  If the end of  the  wide-character  string  is  now  reached,  wcstok
       returns	NULL, to indicate that no tokens were found, and stores an appropriate value in *ptr, so that subsequent calls to wcstok will con-
       tinue to return NULL. Otherwise, the wcstok function recognizes the beginning of a token and returns a pointer  to  it,	but  before  doing
       that,  it  zero-terminates the token by replacing the next wide-character which occurs in delim with a L'' character, and it updates *ptr
       so that subsequent calls will continue searching after the end of recognized token.

RETURN VALUE

       The wcstok function returns a pointer to the next token, or NULL if no further token was found.

NOTES

       The original wcs wide-character string is destructively modified during the operation.

EXAMPLE

       The following code loops over the tokens contained in a wide-character string.

       wchar_t *wcs = ...;
       wchar_t *token;
       wchar_t *state;
       for (token = wcstok(wcs, " 	
", &state);
	    token != NULL;
	    token = wcstok(NULL, " 	
", &state)) {
	 ...
       }

CONFORMING TO

       ISO/ANSI C, UNIX98

SEE ALSO

       strtok(3), wcschr(3)

GNU
								    1999-07-25								 WCSTOK(3)