ustrtok(3) - Linux man page

Name

ustrtok - Retrieves tokens from a string. Allegro game programming library.

Synopsis

#include <allegro.h>

char *ustrtok(char *s, const char *set);

Description

This function retrieves tokens from 's' which are delimited by characters from 'set'. To initiate the search, pass the string to be searched as 's'. For the remaining tokens, pass NULL instead. Warning: Since ustrtok alters the string it is parsing, you should always copy the string to a temporary buffer before parsing it. Also, this function is not reentrant (ie. you cannot parse two strings at the same time). Example:
char *word;
char string[]="some-words with dashes";
char *temp = ustrdup(string);
word = ustrtok(temp, " -");
while (word) {
   allegro_message("Found '%s'\n", word);
   word = ustrtok(NULL, " -");
}
free(temp);

Return Value

Returns a pointer to the token, or NULL if no more are found.

See Also

uconvert(3), ustrchr(3), ustrrchr(3), ustrstr(3), ustrpbrk(3), ustrtok_r(3), allegro_message(3), ustrncpy(3), exgui(3)