compiler/clib/strtok.c

   1 /*
   2     Copyright © 1995-2001, The AROS Development Team. All rights reserved.
   3     $Id$
   4
   5     ANSI C function strtok().
   6 */
   7
   8 /*****************************************************************************
   9
  10     NAME */
  11 #include <string.h>
  12
  13         char * strtok (
  14
  15 /*  SYNOPSIS */
  16         char       * str,
  17         const char * sep)
  18
  19 /*  FUNCTION
  20         Separates a string by the characters in sep.
  21
  22     INPUTS
  23         str - The string to check or NULL if the next word in
  24                 the last string is to be searched.
  25         sep - Characters which separate "words" in str.
  26
  27     RESULT
  28         The first word in str or the next one if str is NULL.
  29
  30     NOTES
  31         The function changes str !
  32
  33     EXAMPLE
  34         char buffer[64];
  35
  36         strcpy (buffer, "Hello, this is a test.");
  37
  38         // Init. Returns "Hello"
  39         strtok (str, " \t,.");
  40
  41         // Next word. Returns "this"
  42         strtok (NULL, " \t,.");
  43
  44         // Next word. Returns "is"
  45         strtok (NULL, " \t");
  46
  47         // Next word. Returns "a"
  48         strtok (NULL, " \t");
  49
  50         // Next word. Returns "test."
  51         strtok (NULL, " \t");
  52
  53         // Next word. Returns NULL.
  54         strtok (NULL, " \t");
  55
  56     BUGS
  57
  58     SEE ALSO
  59
  60     INTERNALS
  61
  62 ******************************************************************************/
  63 {
  64     static char * t;
  65
  66     if (str != NULL)
  67         t = str;
  68     else
  69         str = t;
  70
  71     str += strspn (str, sep);
  72
  73     if (*str == '\0')
  74         return NULL;
  75
  76     t = str;
  77
  78     t += strcspn (str, sep);
  79
  80     if (*t != '\0')
  81         *t ++ = '\0';
  82
  83     return str;
  84 } /* strtok */