.\" Generated by the Allegro makedoc utility
.TH ustrtok 3alleg4 "version 4.4.3" "Allegro" "Allegro manual"
.SH NAME
ustrtok \- Retrieves tokens from a string. Allegro game programming library.\&
.SH SYNOPSIS
.B #include <allegro.h>

.sp
.B char *ustrtok(char *s, const char *set);
.SH 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:

.nf
   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);
.fi
.SH "RETURN VALUE"
Returns a pointer to the token, or NULL if no more are found.

.SH SEE ALSO
.BR uconvert (3alleg4),
.BR ustrchr (3alleg4),
.BR ustrrchr (3alleg4),
.BR ustrstr (3alleg4),
.BR ustrpbrk (3alleg4),
.BR ustrtok_r (3alleg4),
.BR allegro_message (3alleg4),
.BR ustrncpy (3alleg4),
.BR exgui (3alleg4)