STRTOK(3) BSD Library Functions Manual STRTOK(3)

NAME
     ssttrrttookk, ssttrrttookkrr - string tokens

LLIIBBRRAARRYY
     Standard C Library (libc, -lc)

SYNOPSIS
     ##iinncclluuddee <>

     char *
     ssttrrttookk(char *str, const char *sep);

     char *
     ssttrrttookkrr(char *str, const char *sep, char **last);

DESCRIPTION
     TThhiiss iinntteerrffaaccee iiss oobbssoolleetteedd bbyy strsep(33)..

     The ssttrrttookk() function is used to isolate sequential tokens in a null-ter-
     minated string, str.  These tokens are separated in the string by at
     least one of the characters in sep.  The first time that ssttrrttookk() is
     called, str should be specified; subsequent calls, wishing to obtain fur-
     ther tokens from the same string, should pass a null pointer instead.
     The separator string, sep, must be supplied each time, and may change
     between calls.

     The implementation will behave as if no library function calls ssttrrttookk().

     The ssttrrttookkrr() function is a reentrant version of ssttrrttookk().  The context
     pointer last must be provided on each call.  The ssttrrttookkrr() function may
     also be used to nest two parsing loops within one another, as long as
     separate context pointers are used.

     The ssttrrttookk() and ssttrrttookkrr() functions return a pointer to the beginning
     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.

EEXXAAMMPPLLEESS
     The following uses ssttrrttookkrr() to parse two strings using separate con-
     texts:

     char test[80], blah[80];
     char *sep = "\\/:;=-";
     char *word, *phrase, *brkt, *brkb;

     strcpy(test, "This;is.a:test:of=the/string\\tokenizer-function.");

     for (word = strtokr(test, sep, &brkt);
          word;
          word = strtokr(NULL, sep, &brkt))
     {
         strcpy(blah, "blah:blat:blab:blag");

         for (phrase = strtokr(blah, sep, &brkb);
              phrase;
              phrase = strtokr(NULL, sep, &brkb))
         {
             printf("So far we're at %s:%s\n", word, phrase);
         }
     }

SEE ALSO
     memchr(3), strchr(3), strcspn(3), strpbrk(3), strrchr(3), strsep(3),
     strspn(3), strstr(3), wcstok(3)

STANDARDS     The ssttrrttookk() function conforms to ISO/IEC 9899:1990 (``ISO C90'').

BUGS
     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 start-
     ing point, such a sequence of calls would always return NULL.

AUTHORS     Wes Peters, Softweyr LLC: 

     Based on the FreeBSD 3.0 implementation.

BSD                            November 27, 1998                           BSD