1 /*
2 Copyright (c) 2008-2014, Troy D. Hanson http://troydhanson.github.com/uthash/
3 All rights reserved.
4
5 Redistribution and use in source and binary forms, with or without
6 modification, are permitted provided that the following conditions are met:
7
8 * Redistributions of source code must retain the above copyright
9 notice, this list of conditions and the following disclaimer.
10
11 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
12 IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
13 TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
14 PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER
15 OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
16 EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
17 PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
18 PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
19 LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
20 NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
21 SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
22 */
23
24 /* a dynamic array implementation using macros
25 */
26 #ifndef UTARRAY_H
27 #define UTARRAY_H
28
29 #define UTARRAY_VERSION 1.9.9
30
31 #ifdef __GNUC__
32 #define _UNUSED_ __attribute__ ((__unused__))
33 #else
34 #define _UNUSED_
35 #endif
36
37 #include <stddef.h> /* size_t */
38 #include <string.h> /* memset, etc */
39 #include <stdlib.h> /* exit */
40
41 #ifndef oom
42 #define oom() exit(-1)
43 #endif
44
45 typedef void (ctor_f)(void *dst, const void *src);
46 typedef void (dtor_f)(void *elt);
47 typedef void (init_f)(void *elt);
48 typedef struct {
49 size_t sz;
50 init_f *init;
51 ctor_f *copy;
52 dtor_f *dtor;
53 } UT_icd;
54
55 typedef struct {
56 unsigned i,n;/* i: index of next available slot, n: num slots */
57 UT_icd icd; /* initializer, copy and destructor functions */
58 char *d; /* n slots of size icd->sz*/
59 } UT_array;
60
61 #define utarray_init(a,_icd) do { \
62 memset(a,0,sizeof(UT_array)); \
63 (a)->icd=*_icd; \
64 } while(0)
65
66 #define utarray_done(a) do { \
67 if ((a)->n) { \
68 if ((a)->icd.dtor) { \
69 size_t _ut_i; \
70 for(_ut_i=0; _ut_i < (a)->i; _ut_i++) { \
71 (a)->icd.dtor(utarray_eltptr(a,_ut_i)); \
72 } \
73 } \
74 free((a)->d); \
75 } \
76 (a)->n=0; \
77 } while(0)
78
79 #define utarray_new(a,_icd) do { \
80 a=(UT_array*)malloc(sizeof(UT_array)); \
81 utarray_init(a,_icd); \
82 } while(0)
83
84 #define utarray_free(a) do { \
85 utarray_done(a); \
86 free(a); \
87 } while(0)
88
89 #define utarray_reserve(a,by) do { \
90 if (((a)->i+(by)) > ((a)->n)) { \
91 char *utarray_tmp; \
92 while(((a)->i+(by)) > ((a)->n)) { (a)->n = ((a)->n ? (2*(a)->n) : 8); } \
93 utarray_tmp=(char*)realloc((a)->d, (a)->n*(a)->icd.sz); \
94 if (utarray_tmp == NULL) oom(); \
95 (a)->d=utarray_tmp; \
96 } \
97 } while(0)
98
99 #define utarray_push_back(a,p) do { \
100 utarray_reserve(a,1); \
101 if ((a)->icd.copy) { (a)->icd.copy( _utarray_eltptr(a,(a)->i++), p); } \
102 else { memcpy(_utarray_eltptr(a,(a)->i++), p, (a)->icd.sz); }; \
103 } while(0)
104
105 #define utarray_pop_back(a) do { \
106 if ((a)->icd.dtor) { (a)->icd.dtor( _utarray_eltptr(a,--((a)->i))); } \
107 else { (a)->i--; } \
108 } while(0)
109
110 #define utarray_extend_back(a) do { \
111 utarray_reserve(a,1); \
112 if ((a)->icd.init) { (a)->icd.init(_utarray_eltptr(a,(a)->i)); } \
113 else { memset(_utarray_eltptr(a,(a)->i),0,(a)->icd.sz); } \
114 (a)->i++; \
115 } while(0)
116
117 #define utarray_len(a) ((a)->i)
118
119 #define utarray_eltptr(a,j) (((j) < (a)->i) ? _utarray_eltptr(a,j) : NULL)
120 #define _utarray_eltptr(a,j) ((char*)((a)->d + ((a)->icd.sz*(j) )))
121
122 #define utarray_insert(a,p,j) do { \
123 if (j > (a)->i) utarray_resize(a,j); \
124 utarray_reserve(a,1); \
125 if ((j) < (a)->i) { \
126 memmove( _utarray_eltptr(a,(j)+1), _utarray_eltptr(a,j), \
127 ((a)->i - (j))*((a)->icd.sz)); \
128 } \
129 if ((a)->icd.copy) { (a)->icd.copy( _utarray_eltptr(a,j), p); } \
130 else { memcpy(_utarray_eltptr(a,j), p, (a)->icd.sz); }; \
131 (a)->i++; \
132 } while(0)
133
134 #define utarray_inserta(a,w,j) do { \
135 if (utarray_len(w) == 0) break; \
136 if (j > (a)->i) utarray_resize(a,j); \
137 utarray_reserve(a,utarray_len(w)); \
138 if ((j) < (a)->i) { \
139 memmove(_utarray_eltptr(a,(j)+utarray_len(w)), \
140 _utarray_eltptr(a,j), \
141 ((a)->i - (j))*((a)->icd.sz)); \
142 } \
143 if ((a)->icd.copy) { \
144 size_t _ut_i; \
145 for(_ut_i=0;_ut_i<(w)->i;_ut_i++) { \
146 (a)->icd.copy(_utarray_eltptr(a,j+_ut_i), _utarray_eltptr(w,_ut_i)); \
147 } \
148 } else { \
149 memcpy(_utarray_eltptr(a,j), _utarray_eltptr(w,0), \
150 utarray_len(w)*((a)->icd.sz)); \
151 } \
152 (a)->i += utarray_len(w); \
153 } while(0)
154
155 #define utarray_resize(dst,num) do { \
156 size_t _ut_i; \
157 if (dst->i > (size_t)(num)) { \
158 if ((dst)->icd.dtor) { \
159 for(_ut_i=num; _ut_i < dst->i; _ut_i++) { \
160 (dst)->icd.dtor(utarray_eltptr(dst,_ut_i)); \
161 } \
162 } \
163 } else if (dst->i < (size_t)(num)) { \
164 utarray_reserve(dst,num-dst->i); \
165 if ((dst)->icd.init) { \
166 for(_ut_i=dst->i; _ut_i < num; _ut_i++) { \
167 (dst)->icd.init(utarray_eltptr(dst,_ut_i)); \
168 } \
169 } else { \
170 memset(_utarray_eltptr(dst,dst->i),0,(dst)->icd.sz*(num-dst->i)); \
171 } \
172 } \
173 dst->i = num; \
174 } while(0)
175
176 #define utarray_concat(dst,src) do { \
177 utarray_inserta((dst),(src),utarray_len(dst)); \
178 } while(0)
179
180 #define utarray_erase(a,pos,len) do { \
181 if ((a)->icd.dtor) { \
182 size_t _ut_i; \
183 for(_ut_i=0; _ut_i < len; _ut_i++) { \
184 (a)->icd.dtor(utarray_eltptr((a),pos+_ut_i)); \
185 } \
186 } \
187 if ((a)->i > (pos+len)) { \
188 memmove( _utarray_eltptr((a),pos), _utarray_eltptr((a),pos+len), \
189 (((a)->i)-(pos+len))*((a)->icd.sz)); \
190 } \
191 (a)->i -= (len); \
192 } while(0)
193
194 #define utarray_renew(a,u) do { \
195 if (a) utarray_clear(a); \
196 else utarray_new((a),(u)); \
197 } while(0)
198
199 #define utarray_clear(a) do { \
200 if ((a)->i > 0) { \
201 if ((a)->icd.dtor) { \
202 size_t _ut_i; \
203 for(_ut_i=0; _ut_i < (a)->i; _ut_i++) { \
204 (a)->icd.dtor(utarray_eltptr(a,_ut_i)); \
205 } \
206 } \
207 (a)->i = 0; \
208 } \
209 } while(0)
210
211 #define utarray_sort(a,cmp) do { \
212 qsort((a)->d, (a)->i, (a)->icd.sz, cmp); \
213 } while(0)
214
215 #define utarray_find(a,v,cmp) bsearch((v),(a)->d,(a)->i,(a)->icd.sz,cmp)
216
217 #define utarray_front(a) (((a)->i) ? (_utarray_eltptr(a,0)) : NULL)
218 #define utarray_next(a,e) (((e)==NULL) ? utarray_front(a) : ((((a)->i) > (utarray_eltidx(a,e)+1)) ? _utarray_eltptr(a,utarray_eltidx(a,e)+1) : NULL))
219 #define utarray_prev(a,e) (((e)==NULL) ? utarray_back(a) : ((utarray_eltidx(a,e) > 0) ? _utarray_eltptr(a,utarray_eltidx(a,e)-1) : NULL))
220 #define utarray_back(a) (((a)->i) ? (_utarray_eltptr(a,(a)->i-1)) : NULL)
221 #define utarray_eltidx(a,e) (((char*)(e) >= (char*)((a)->d)) ? (((char*)(e) - (char*)((a)->d))/(size_t)(a)->icd.sz) : (unsigned int)-1)
222
223 /* last we pre-define a few icd for common utarrays of ints and strings */
224 static void utarray_str_cpy(void *dst, const void *src) {
225 char **_src = (char**)src, **_dst = (char**)dst;
226 *_dst = (*_src == NULL) ? NULL : strdup(*_src);
227 }
228 static void utarray_str_dtor(void *elt) {
229 char **eltc = (char**)elt;
230 if (*eltc) free(*eltc);
231 }
232 static const UT_icd ut_str_icd _UNUSED_ = {sizeof(char*),NULL,utarray_str_cpy,utarray_str_dtor};
233 static const UT_icd ut_int_icd _UNUSED_ = {sizeof(int),NULL,NULL,NULL};
234 static const UT_icd ut_ptr_icd _UNUSED_ = {sizeof(void*),NULL,NULL,NULL};
235
236
237 #endif /* UTARRAY_H */