home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 8 / FreshFishVol8-CD1.bin / gnu / man / cat3 / strtok.0 < prev    next >
Text File  |  1993-12-07  |  2KB  |  67 lines
  1.  
  2. STRTOK(3)                  UNIX Programmer's Manual                  STRTOK(3)
  3.  
  4. NNAAMMEE
  5.      ssttrrttookk, ssttrrsseepp - string token operations
  6.  
  7. SSYYNNOOPPSSIISS
  8.      ##iinncclluuddee <<ssttrriinngg..hh>>
  9.  
  10.      _c_h_a_r _*
  11.      ssttrrttookk(_c_h_a_r _*_s_t_r, _c_o_n_s_t _c_h_a_r _*_s_e_p)
  12.  
  13. DDEESSCCRRIIPPTTIIOONN
  14.      TThhiiss iinntteerrffaaccee iiss oobbssoolleetteedd bbyy ssttrrsseepp((33))..
  15.  
  16.      The ssttrrttookk() function is used to isolate sequential tokens in a null­
  17.      terminated string, _s_t_r. These tokens are separated in the string by at
  18.      least one of the characters in _s_e_p. The first time that ssttrrttookk() is
  19.      called, _s_t_r should be specified; subsequent calls, wishing to obtain fur­
  20.      ther tokens from the same string, should pass a null pointer instead.
  21.      The separator string, _s_e_p, must be supplied each time, and may change be­
  22.      tween calls.
  23.  
  24.      The ssttrrttookk() function returns a pointer to the beginning of each subse­
  25.      quent token in the string, after replacing the token itself with a NUL
  26.      character.  When no more tokens remain, a null pointer is returned.
  27.  
  28. SSEEEE AALLSSOO
  29.      index(3),  memchr(3),  rindex(3),  strchr(3),  strcspn(3),  strpbrk(3),
  30.      strrchr(3),  strsep(3),  strspn(3),  strstr(3)
  31.  
  32. SSTTAANNDDAARRDDSS
  33.      The ssttrrttookk() function conforms to ANSI C3.159­1989 (``ANSI C'').
  34.  
  35. BBUUGGSS
  36.      There is no way to get tokens from multiple strings simultaneously.
  37.  
  38.      The System V ssttrrttookk(), if handed a string containing only delimiter char­
  39.      acters, will not alter the next starting point, so that a call to
  40.      ssttrrttookk() with a different (or empty) delimiter string may return a non­
  41.      NULL value.  Since this implementation always alters the next starting
  42.      point, such a sequence of calls would always return NULL.
  43.  
  44. 3rd Berkeley Distribution        June 29, 1991                               1
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.