debian man page for ustrtok

Query: ustrtok

OS: debian

Section: 3alleg4

Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar

ustrtok(3alleg4)						  Allegro manual						  ustrtok(3alleg4)

NAME
ustrtok - Retrieves tokens from a string. Allegro game programming library.
SYNOPSIS
#include <allegro.h> char *ustrtok(char *s, const char *set);
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' ", word); word = ustrtok(NULL, " -"); } free(temp);
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.2 ustrtok(3alleg4)
Related Man Pages
exgui(3alleg4) - debian
exgui(3alleg4) - opendarwin
ustrtok(3alleg4) - suse
ustrtok(3alleg4) - netbsd
ustrtok(3alleg4) - v7
Similar Topics in the Unix Linux Community
string function
string returning function
'Can we not tempt you back?'
string parsing using UNIX
sed substitution or awk, need to direct change the file