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