1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
|
/*
String splitter function
Copyright (C) 1999, Joe Orton <joe@orton.demon.co.uk>
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
*/
/* Splits str into component parts using given seperator,
* skipping given whitespace around separators and at the
* beginning and end of str. Separators are ignored within
* any pair of characters specified as being quotes.
* Returns array of components followed by a NULL pointer. The
* components are taken from dynamically allocated memory, and
* the entire array can be easily freed using strsplit_free.
*
* aka: What strtok should have been.
*/
char **strsplit( const char *str, const char seperator,
const char *quotes, const char *whitespace );
/* A bit like strsplit, except each component is split into a pair.
* Each pair is returned consecutively in the return array.
* e.g.:
* strpairs( "aa=bb,cc=dd", ',', '=', NULL, NULL )
* => "aa", "bb", "cc", "dd", NULL, NULL
* Note, that if a component is *missing* it's key/value separator,
* then the 'value' in the array will be a NULL pointer. But, if the
* value is zero-length (i.e., the component separator follows directly
* after the key/value separator, or with only whitespace inbetween),
* then the value in the array will be a zero-length string.
* e.g.:
* strpairs( "aaaa,bb=cc,dd=,ee=ff", ',', '=', NULL, NULL )
* => "aaaa", NULL, "bb", "cc", "dd", "", "ee", "ff"
* A NULL key indicates the end of the array (the value will also
* be NULL, for convenience).
*/
char **strpairs( const char *str, const char compsep, const char kvsep,
const char *quotes, const char *whitespace );
/* Frees the array returned by strsplit */
void strsplit_free( char **components );
/* Frees the array returned by strpairs */
void strpairs_free( char **pairs );
/* Returns a string which is str with ch stripped from
* beggining and end, if present in either. The string returned
* is dynamically allocated using malloc.
*
* e.g. strstrip( "abbba", 'a' ) => "bbb". */
char *strstrip( const char *str, const char ch );
|
