2999
|
1 /* str-list.h: Declarations for string lists. |
|
2 |
|
3 Copyright (C) 1993, 94 Karl Berry. |
|
4 |
|
5 This library is free software; you can redistribute it and/or |
|
6 modify it under the terms of the GNU Library General Public |
|
7 License as published by the Free Software Foundation; either |
|
8 version 2 of the License, or (at your option) any later version. |
|
9 |
|
10 This library is distributed in the hope that it will be useful, |
|
11 but WITHOUT ANY WARRANTY; without even the implied warranty of |
|
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU |
|
13 Library General Public License for more details. |
|
14 |
|
15 You should have received a copy of the GNU Library General Public |
|
16 License along with this library; if not, write to the Free Software |
|
17 Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. */ |
|
18 |
|
19 #ifndef KPATHSEA_STR_LIST_H |
|
20 #define KPATHSEA_STR_LIST_H |
|
21 |
|
22 #include <kpathsea/c-proto.h> |
|
23 #include <kpathsea/types.h> |
|
24 |
|
25 |
|
26 /* Lists of strings; used for, e.g., directory lists. */ |
|
27 |
|
28 typedef struct |
|
29 { |
|
30 unsigned length; |
|
31 string *list; |
|
32 } str_list_type; |
|
33 |
|
34 #define STR_LIST_LENGTH(l) ((l).length) |
|
35 #define STR_LIST(l) ((l).list) |
|
36 #define STR_LIST_ELT(l, n) STR_LIST (l)[n] |
|
37 #define STR_LIST_LAST_ELT(l) STR_LIST_ELT (l, STR_LIST_LENGTH (l) - 1) |
|
38 |
|
39 /* Return a new, empty, list. */ |
|
40 extern str_list_type str_list_init P1H(void); |
|
41 |
|
42 /* Append the string S to the list L. It's up to the caller to not |
|
43 deallocate S; we don't copy it. Also up to the caller to terminate |
|
44 the list with a null entry. */ |
|
45 extern void str_list_add P2H(str_list_type *l, string s); |
|
46 |
|
47 /* Append all the elements from MORE to TARGET. */ |
|
48 extern void str_list_concat P2H(str_list_type * target, str_list_type more); |
|
49 |
|
50 /* Free the space for the list elements (but not the list elements |
|
51 themselves). */ |
|
52 extern void str_list_free P1H(str_list_type *l); |
|
53 |
|
54 #endif /* not KPATHSEA_STR_LIST_H */ |