ustrtok_r3alleg

Usage

Overview

Reentrant version of ustrtok. The `last' parameter is used to keep track of where the parsing is up to and must be a pointer to a char * variable allocated by the user that remains the same while parsing the same string. Example:

   char *word, *last;
   char string[]="some-words with dashes";
   char *temp = ustrdup(string);
   word = ustrtok_r(string, " -", &last);
   while (word) {
      allegro_message("Found `%s'\n", word);
      word = ustrtok_r(NULL, " -", &last);
   }
   free(temp);

Return value

Returns a pointer to the token, or NULL if no more are found. You can free the memory pointed to by `last' once NULL is returned.