STRTOK(3) 1990 STRTOK(3) NNAAMMEE strtok, strsep - string token operations SSYYNNOOPPSSIISS ##iinncclluuddee <<ssttrriinngg..hh>> cchhaarr ** ssttrrttookk((cchhaarr **ssttrr,, ccoonnsstt cchhaarr **sseepp));; DDEESSCCRRIIPPTTIIOONN TThhiiss iinntteerrffaaccee iiss oobbssoolleetteedd bbyy ssttrrsseepp((33)).. _S_t_r_t_o_k is used to isolate sequential tokens in a null- terminated string, _s_t_r. These tokens are separated in the string by oonnee oorr mmoorree of the characters in _s_e_p. The first time that _s_t_r_t_o_k is called, _s_t_r should be specified; subse- quent calls, wishing to obtain further tokens from the same string, should pass a null pointer instead. The separator string, _s_e_p, must be supplied each time, and may change between calls. _S_t_r_t_o_k returns a pointer to the start of each subsequent token in the string, after replacing the token itself with a NUL character. When no more tokens remain, a null pointer is returned. SSEEEE AALLSSOO index(3), memchr(3), rindex(3), strchr(3), strcspn(3), strpbrk(3), strrchr(3), strsep(3), strspn(3), strstr(3) SSTTAANNDDAARRDDSS SSttrrttookk conforms to ANSI X3.159-1989 (``ANSI C''). BBUUGGSS There is no way to get tokens from multiple strings simul- taneously. The System V ssttrrttookk will, if handed a string containing only delimiter characters, not alter the next starting point, so that a call to ssttrrttookk with a different (or empty) delimiter string may return a non-NULL value. Since this implementa- tion always alters the next starting point, such a sequence of calls would always return NULL. Printed 7/27/90 June 1