BreakingChanges: document removal of grafting
[git/gitster.git] / string-list.c
blob954569f381d8d7ea2e1c6f1333b1e8379ffe2fe8
1 #include "git-compat-util.h"
2 #include "string-list.h"
4 void string_list_init_nodup(struct string_list *list)
6 struct string_list blank = STRING_LIST_INIT_NODUP;
7 memcpy(list, &blank, sizeof(*list));
10 void string_list_init_dup(struct string_list *list)
12 struct string_list blank = STRING_LIST_INIT_DUP;
13 memcpy(list, &blank, sizeof(*list));
16 /* if there is no exact match, point to the index where the entry could be
17 * inserted */
18 static int get_entry_index(const struct string_list *list, const char *string,
19 int *exact_match)
21 int left = -1, right = list->nr;
22 compare_strings_fn cmp = list->cmp ? list->cmp : strcmp;
24 while (left + 1 < right) {
25 int middle = left + (right - left) / 2;
26 int compare = cmp(string, list->items[middle].string);
27 if (compare < 0)
28 right = middle;
29 else if (compare > 0)
30 left = middle;
31 else {
32 *exact_match = 1;
33 return middle;
37 *exact_match = 0;
38 return right;
41 /* returns -1-index if already exists */
42 static int add_entry(int insert_at, struct string_list *list, const char *string)
44 int exact_match = 0;
45 int index = insert_at != -1 ? insert_at : get_entry_index(list, string, &exact_match);
47 if (exact_match)
48 return -1 - index;
50 ALLOC_GROW(list->items, list->nr+1, list->alloc);
51 if (index < list->nr)
52 MOVE_ARRAY(list->items + index + 1, list->items + index,
53 list->nr - index);
54 list->items[index].string = list->strdup_strings ?
55 xstrdup(string) : (char *)string;
56 list->items[index].util = NULL;
57 list->nr++;
59 return index;
62 struct string_list_item *string_list_insert(struct string_list *list, const char *string)
64 int index = add_entry(-1, list, string);
66 if (index < 0)
67 index = -1 - index;
69 return list->items + index;
72 void string_list_remove(struct string_list *list, const char *string,
73 int free_util)
75 int exact_match;
76 int i = get_entry_index(list, string, &exact_match);
78 if (exact_match) {
79 if (list->strdup_strings)
80 free(list->items[i].string);
81 if (free_util)
82 free(list->items[i].util);
84 list->nr--;
85 MOVE_ARRAY(list->items + i, list->items + i + 1, list->nr - i);
89 int string_list_has_string(const struct string_list *list, const char *string)
91 int exact_match;
92 get_entry_index(list, string, &exact_match);
93 return exact_match;
96 int string_list_find_insert_index(const struct string_list *list, const char *string,
97 int negative_existing_index)
99 int exact_match;
100 int index = get_entry_index(list, string, &exact_match);
101 if (exact_match)
102 index = -1 - (negative_existing_index ? index : 0);
103 return index;
106 struct string_list_item *string_list_lookup(struct string_list *list, const char *string)
108 int exact_match, i = get_entry_index(list, string, &exact_match);
109 if (!exact_match)
110 return NULL;
111 return list->items + i;
114 void string_list_remove_duplicates(struct string_list *list, int free_util)
116 if (list->nr > 1) {
117 int src, dst;
118 compare_strings_fn cmp = list->cmp ? list->cmp : strcmp;
119 for (src = dst = 1; src < list->nr; src++) {
120 if (!cmp(list->items[dst - 1].string, list->items[src].string)) {
121 if (list->strdup_strings)
122 free(list->items[src].string);
123 if (free_util)
124 free(list->items[src].util);
125 } else
126 list->items[dst++] = list->items[src];
128 list->nr = dst;
132 int for_each_string_list(struct string_list *list,
133 string_list_each_func_t fn, void *cb_data)
135 int i, ret = 0;
136 for (i = 0; i < list->nr; i++)
137 if ((ret = fn(&list->items[i], cb_data)))
138 break;
139 return ret;
142 void filter_string_list(struct string_list *list, int free_util,
143 string_list_each_func_t want, void *cb_data)
145 int src, dst = 0;
146 for (src = 0; src < list->nr; src++) {
147 if (want(&list->items[src], cb_data)) {
148 list->items[dst++] = list->items[src];
149 } else {
150 if (list->strdup_strings)
151 free(list->items[src].string);
152 if (free_util)
153 free(list->items[src].util);
156 list->nr = dst;
159 static int item_is_not_empty(struct string_list_item *item, void *data UNUSED)
161 return *item->string != '\0';
164 void string_list_remove_empty_items(struct string_list *list, int free_util)
166 filter_string_list(list, free_util, item_is_not_empty, NULL);
169 void string_list_clear(struct string_list *list, int free_util)
171 if (list->items) {
172 int i;
173 if (list->strdup_strings) {
174 for (i = 0; i < list->nr; i++)
175 free(list->items[i].string);
177 if (free_util) {
178 for (i = 0; i < list->nr; i++)
179 free(list->items[i].util);
181 free(list->items);
183 list->items = NULL;
184 list->nr = list->alloc = 0;
187 void string_list_clear_func(struct string_list *list, string_list_clear_func_t clearfunc)
189 if (list->items) {
190 int i;
191 if (clearfunc) {
192 for (i = 0; i < list->nr; i++)
193 clearfunc(list->items[i].util, list->items[i].string);
195 if (list->strdup_strings) {
196 for (i = 0; i < list->nr; i++)
197 free(list->items[i].string);
199 free(list->items);
201 list->items = NULL;
202 list->nr = list->alloc = 0;
205 void string_list_setlen(struct string_list *list, size_t nr)
207 if (list->strdup_strings)
208 BUG("cannot setlen a string_list which owns its entries");
209 if (nr > list->nr)
210 BUG("cannot grow a string_list with setlen");
211 list->nr = nr;
214 struct string_list_item *string_list_append_nodup(struct string_list *list,
215 char *string)
217 struct string_list_item *retval;
218 ALLOC_GROW(list->items, list->nr + 1, list->alloc);
219 retval = &list->items[list->nr++];
220 retval->string = string;
221 retval->util = NULL;
222 return retval;
225 struct string_list_item *string_list_append(struct string_list *list,
226 const char *string)
228 return string_list_append_nodup(
229 list,
230 list->strdup_strings ? xstrdup(string) : (char *)string);
234 * Encapsulate the compare function pointer because ISO C99 forbids
235 * casting from void * to a function pointer and vice versa.
237 struct string_list_sort_ctx
239 compare_strings_fn cmp;
242 static int cmp_items(const void *a, const void *b, void *ctx)
244 struct string_list_sort_ctx *sort_ctx = ctx;
245 const struct string_list_item *one = a;
246 const struct string_list_item *two = b;
247 return sort_ctx->cmp(one->string, two->string);
250 void string_list_sort(struct string_list *list)
252 struct string_list_sort_ctx sort_ctx = {list->cmp ? list->cmp : strcmp};
254 QSORT_S(list->items, list->nr, cmp_items, &sort_ctx);
257 struct string_list_item *unsorted_string_list_lookup(struct string_list *list,
258 const char *string)
260 struct string_list_item *item;
261 compare_strings_fn cmp = list->cmp ? list->cmp : strcmp;
263 for_each_string_list_item(item, list)
264 if (!cmp(string, item->string))
265 return item;
266 return NULL;
269 int unsorted_string_list_has_string(struct string_list *list,
270 const char *string)
272 return unsorted_string_list_lookup(list, string) != NULL;
275 void unsorted_string_list_delete_item(struct string_list *list, int i, int free_util)
277 if (list->strdup_strings)
278 free(list->items[i].string);
279 if (free_util)
280 free(list->items[i].util);
281 list->items[i] = list->items[list->nr-1];
282 list->nr--;
285 int string_list_split(struct string_list *list, const char *string,
286 int delim, int maxsplit)
288 int count = 0;
289 const char *p = string, *end;
291 if (!list->strdup_strings)
292 die("internal error in string_list_split(): "
293 "list->strdup_strings must be set");
294 for (;;) {
295 count++;
296 if (maxsplit >= 0 && count > maxsplit) {
297 string_list_append(list, p);
298 return count;
300 end = strchr(p, delim);
301 if (end) {
302 string_list_append_nodup(list, xmemdupz(p, end - p));
303 p = end + 1;
304 } else {
305 string_list_append(list, p);
306 return count;
311 int string_list_split_in_place(struct string_list *list, char *string,
312 const char *delim, int maxsplit)
314 int count = 0;
315 char *p = string, *end;
317 if (list->strdup_strings)
318 die("internal error in string_list_split_in_place(): "
319 "list->strdup_strings must not be set");
320 for (;;) {
321 count++;
322 if (maxsplit >= 0 && count > maxsplit) {
323 string_list_append(list, p);
324 return count;
326 end = strpbrk(p, delim);
327 if (end) {
328 *end = '\0';
329 string_list_append(list, p);
330 p = end + 1;
331 } else {
332 string_list_append(list, p);
333 return count;