Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
ustrtok(3)			Allegro	manual			    ustrtok(3)

NAME
       ustrtok	- Retrieves tokens from	a string. Allegro game programming li-
       brary.

SYNOPSIS
       #include	<allegro.h>

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

DESCRIPTION
       This function retrieves tokens from `s' which are delimited by  charac-
       ters 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). Ex-
       ample:

	  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),	 ustr-
       tok_r(3), allegro_message(3), ustrncpy(3), exgui(3)

Allegro				 version 4.4.3			    ustrtok(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=ustrtok&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>

home | help