1 const char ssplit_rcs[] = "$Id: ssplit.c,v 1.19 2012/07/23 12:46:40 fabiankeil Exp $";
2 /*********************************************************************
4 * File : $Source: /cvsroot/ijbswa/current/ssplit.c,v $
6 * Purpose : A function to split a string at specified delimiters.
8 * Copyright : Written by and Copyright (C) 2001-2012 the
9 * Privoxy team. http://www.privoxy.org/
11 * Based on the Internet Junkbuster originally written
12 * by and Copyright (C) 1997 Anonymous Coders and
13 * Junkbusters Corporation. http://www.junkbusters.com
15 * This program is free software; you can redistribute it
16 * and/or modify it under the terms of the GNU General
17 * Public License as published by the Free Software
18 * Foundation; either version 2 of the License, or (at
19 * your option) any later version.
21 * This program is distributed in the hope that it will
22 * be useful, but WITHOUT ANY WARRANTY; without even the
23 * implied warranty of MERCHANTABILITY or FITNESS FOR A
24 * PARTICULAR PURPOSE. See the GNU General Public
25 * License for more details.
27 * The GNU General Public License should be included with
28 * this file. If not, you can view it at
29 * http://www.gnu.org/copyleft/gpl.html
30 * or write to the Free Software Foundation, Inc., 59
31 * Temple Place - Suite 330, Boston, MA 02111-1307, USA.
33 *********************************************************************/
45 const char ssplit_h_rcs[] = SSPLIT_H_VERSION;
48 /*********************************************************************
52 * Description : Split a string using delimiters in `delim'. Results
56 * 1 : str = string to split. Will be split in place
57 * (i.e. do not free until you've finished with vec,
58 * previous contents will be trashed by the call).
59 * 2 : delim = array of delimiters (if NULL, uses " \t").
60 * 3 : vec[] = results vector (aka. array) [out]
61 * 4 : vec_len = number of usable slots in the vector (aka. array size)
63 * Returns : -1 => Error: vec_len is too small to hold all the
64 * data, or str == NULL.
65 * >=0 => the number of fields put in `vec'.
66 * On error, vec and str may still have been overwritten.
68 *********************************************************************/
69 int ssplit(char *str, const char *delim, char *vec[], size_t vec_len)
71 unsigned char is_delim[256];
72 unsigned char char_type;
87 /* Build is_delim array */
89 memset(is_delim, '\0', sizeof(is_delim));
93 delim = " \t"; /* default field separators */
98 is_delim[(unsigned)(unsigned char)*delim++] = SEPARATOR;
101 is_delim[(unsigned)(unsigned char)'\0'] = TERMINATOR;
102 is_delim[(unsigned)(unsigned char)'\n'] = TERMINATOR;
107 /* Skip leading separators. XXX: Why do they matter? */
108 while (is_delim[(unsigned)(unsigned char)*str] == SEPARATOR)
113 /* The first pointer is the beginning of string */
114 if (is_delim[(unsigned)(unsigned char)*str] == WANTED)
117 * The first character in this field is not a
118 * delimiter or the end of string, so save it.
120 if (vec_count >= vec_len)
122 return(-1); /* overflow */
124 vec[vec_count++] = str;
127 while ((char_type = is_delim[(unsigned)(unsigned char)*str]) != TERMINATOR)
129 if (char_type == SEPARATOR)
131 /* the char is a separator */
133 /* null terminate the substring */
136 /* Check if we want to save this field */
137 if (is_delim[(unsigned)(unsigned char)*str] == WANTED)
140 * The first character in this field is not a
141 * delimiter or the end of string. So save it.
143 if (vec_count >= vec_len)
145 return(-1); /* overflow */
147 vec[vec_count++] = str;
155 /* null terminate the substring */
156 /* XXX: this shouldn't be necessary, so assert that it isn't. */
157 assert(*str == '\0');