4.3BSD-Reno/share/man/cat3/strtok.0

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