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.2			    ustrtok(3)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | SEE ALSO

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

home | help