ustrtok - Retrieves tokens from a string. Allegro game programming library.
Contents
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 re-entrant (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);
Name
ustrtok - Retrieves tokens from a string. Allegro game programming library.
Return Value
Returns a pointer to the token, or NULL if no more are found.
See Also
uconvert(3alleg4), ustrchr(3alleg4), ustrrchr(3alleg4), ustrstr(3alleg4), ustrpbrk(3alleg4), ustrtok_r(3alleg4), allegro_message(3alleg4), ustrncpy(3alleg4), exgui(3alleg4) Allegro version 4.4.3 ustrtok(3alleg4)
Synopsis
#include<allegro.h>char*ustrtok(char*s,constchar*set);
