STRTOK(3) BSD Programmer's Manual STRTOK(3) NNAAMMEE ssttrrttookk, ssttrrsseepp - string token operations SSYYNNOOPPSSIISS ##iinncclluuddee <<ssttrriinngg..hh>> _c_h_a_r _* ssttrrttookk(_c_h_a_r _*_s_t_r, _c_o_n_s_t _c_h_a_r _*_s_e_p); DDEESSCCRRIIPPTTIIOONN TThhiiss iinntteerrffaaccee iiss oobbssoolleetteedd bbyy ssttrrsseepp((33)).. The ssttrrttookk() function is used to isolate sequential tokens in a null- terminated string, _s_t_r. These tokens are separated in the string by at least one of the characters in _s_e_p. The first time that ssttrrttookk() is called, _s_t_r should be specified; subsequent calls, wishing to obtain fur- ther 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 be- tween calls. The ssttrrttookk() function returns a pointer to the beginning of each subse- quent 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 The ssttrrttookk() function conforms to ANSI C X3.159-1989 (``ANSI C ''). BBUUGGSS There is no way to get tokens from multiple strings simultaneously. The System V ssttrrttookk(), if handed a string containing only delimiter char- acters, will 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 implementation always alters the next starting point, such a sequence of calls would always return NULL. 3rd Berkeley Distribution June 4, 1993 1