Documentation: spelling and grammar fixes
[alt-git.git] / string-list.c
bloba0cf0cfe88ee38f35ec33662778ec1bd7036a127
1 #include "cache.h"
2 #include "string-list.h"
4 void string_list_init(struct string_list *list, int strdup_strings)
6 memset(list, 0, sizeof(*list));
7 list->strdup_strings = strdup_strings;
10 /* if there is no exact match, point to the index where the entry could be
11 * inserted */
12 static int get_entry_index(const struct string_list *list, const char *string,
13 int *exact_match)
15 int left = -1, right = list->nr;
16 compare_strings_fn cmp = list->cmp ? list->cmp : strcmp;
18 while (left + 1 < right) {
19 int middle = left + (right - left) / 2;
20 int compare = cmp(string, list->items[middle].string);
21 if (compare < 0)
22 right = middle;
23 else if (compare > 0)
24 left = middle;
25 else {
26 *exact_match = 1;
27 return middle;
31 *exact_match = 0;
32 return right;
35 /* returns -1-index if already exists */
36 static int add_entry(int insert_at, struct string_list *list, const char *string)
38 int exact_match = 0;
39 int index = insert_at != -1 ? insert_at : get_entry_index(list, string, &exact_match);
41 if (exact_match)
42 return -1 - index;
44 ALLOC_GROW(list->items, list->nr+1, list->alloc);
45 if (index < list->nr)
46 MOVE_ARRAY(list->items + index + 1, list->items + index,
47 list->nr - index);
48 list->items[index].string = list->strdup_strings ?
49 xstrdup(string) : (char *)string;
50 list->items[index].util = NULL;
51 list->nr++;
53 return index;
56 struct string_list_item *string_list_insert(struct string_list *list, const char *string)
58 int index = add_entry(-1, list, string);
60 if (index < 0)
61 index = -1 - index;
63 return list->items + index;
66 void string_list_remove(struct string_list *list, const char *string,
67 int free_util)
69 int exact_match;
70 int i = get_entry_index(list, string, &exact_match);
72 if (exact_match) {
73 if (list->strdup_strings)
74 free(list->items[i].string);
75 if (free_util)
76 free(list->items[i].util);
78 list->nr--;
79 MOVE_ARRAY(list->items + i, list->items + i + 1, list->nr - i);
83 int string_list_has_string(const struct string_list *list, const char *string)
85 int exact_match;
86 get_entry_index(list, string, &exact_match);
87 return exact_match;
90 int string_list_find_insert_index(const struct string_list *list, const char *string,
91 int negative_existing_index)
93 int exact_match;
94 int index = get_entry_index(list, string, &exact_match);
95 if (exact_match)
96 index = -1 - (negative_existing_index ? index : 0);
97 return index;
100 struct string_list_item *string_list_lookup(struct string_list *list, const char *string)
102 int exact_match, i = get_entry_index(list, string, &exact_match);
103 if (!exact_match)
104 return NULL;
105 return list->items + i;
108 void string_list_remove_duplicates(struct string_list *list, int free_util)
110 if (list->nr > 1) {
111 int src, dst;
112 compare_strings_fn cmp = list->cmp ? list->cmp : strcmp;
113 for (src = dst = 1; src < list->nr; src++) {
114 if (!cmp(list->items[dst - 1].string, list->items[src].string)) {
115 if (list->strdup_strings)
116 free(list->items[src].string);
117 if (free_util)
118 free(list->items[src].util);
119 } else
120 list->items[dst++] = list->items[src];
122 list->nr = dst;
126 int for_each_string_list(struct string_list *list,
127 string_list_each_func_t fn, void *cb_data)
129 int i, ret = 0;
130 for (i = 0; i < list->nr; i++)
131 if ((ret = fn(&list->items[i], cb_data)))
132 break;
133 return ret;
136 void filter_string_list(struct string_list *list, int free_util,
137 string_list_each_func_t want, void *cb_data)
139 int src, dst = 0;
140 for (src = 0; src < list->nr; src++) {
141 if (want(&list->items[src], cb_data)) {
142 list->items[dst++] = list->items[src];
143 } else {
144 if (list->strdup_strings)
145 free(list->items[src].string);
146 if (free_util)
147 free(list->items[src].util);
150 list->nr = dst;
153 static int item_is_not_empty(struct string_list_item *item, void *unused)
155 return *item->string != '\0';
158 void string_list_remove_empty_items(struct string_list *list, int free_util) {
159 filter_string_list(list, free_util, item_is_not_empty, NULL);
162 void string_list_clear(struct string_list *list, int free_util)
164 if (list->items) {
165 int i;
166 if (list->strdup_strings) {
167 for (i = 0; i < list->nr; i++)
168 free(list->items[i].string);
170 if (free_util) {
171 for (i = 0; i < list->nr; i++)
172 free(list->items[i].util);
174 free(list->items);
176 list->items = NULL;
177 list->nr = list->alloc = 0;
180 void string_list_clear_func(struct string_list *list, string_list_clear_func_t clearfunc)
182 if (list->items) {
183 int i;
184 if (clearfunc) {
185 for (i = 0; i < list->nr; i++)
186 clearfunc(list->items[i].util, list->items[i].string);
188 if (list->strdup_strings) {
189 for (i = 0; i < list->nr; i++)
190 free(list->items[i].string);
192 free(list->items);
194 list->items = NULL;
195 list->nr = list->alloc = 0;
199 void print_string_list(const struct string_list *p, const char *text)
201 int i;
202 if ( text )
203 printf("%s\n", text);
204 for (i = 0; i < p->nr; i++)
205 printf("%s:%p\n", p->items[i].string, p->items[i].util);
208 struct string_list_item *string_list_append_nodup(struct string_list *list,
209 char *string)
211 struct string_list_item *retval;
212 ALLOC_GROW(list->items, list->nr + 1, list->alloc);
213 retval = &list->items[list->nr++];
214 retval->string = string;
215 retval->util = NULL;
216 return retval;
219 struct string_list_item *string_list_append(struct string_list *list,
220 const char *string)
222 return string_list_append_nodup(
223 list,
224 list->strdup_strings ? xstrdup(string) : (char *)string);
227 static int cmp_items(const void *a, const void *b, void *ctx)
229 compare_strings_fn cmp = ctx;
230 const struct string_list_item *one = a;
231 const struct string_list_item *two = b;
232 return cmp(one->string, two->string);
235 void string_list_sort(struct string_list *list)
237 QSORT_S(list->items, list->nr, cmp_items,
238 list->cmp ? list->cmp : strcmp);
241 struct string_list_item *unsorted_string_list_lookup(struct string_list *list,
242 const char *string)
244 struct string_list_item *item;
245 compare_strings_fn cmp = list->cmp ? list->cmp : strcmp;
247 for_each_string_list_item(item, list)
248 if (!cmp(string, item->string))
249 return item;
250 return NULL;
253 int unsorted_string_list_has_string(struct string_list *list,
254 const char *string)
256 return unsorted_string_list_lookup(list, string) != NULL;
259 void unsorted_string_list_delete_item(struct string_list *list, int i, int free_util)
261 if (list->strdup_strings)
262 free(list->items[i].string);
263 if (free_util)
264 free(list->items[i].util);
265 list->items[i] = list->items[list->nr-1];
266 list->nr--;
269 int string_list_split(struct string_list *list, const char *string,
270 int delim, int maxsplit)
272 int count = 0;
273 const char *p = string, *end;
275 if (!list->strdup_strings)
276 die("internal error in string_list_split(): "
277 "list->strdup_strings must be set");
278 for (;;) {
279 count++;
280 if (maxsplit >= 0 && count > maxsplit) {
281 string_list_append(list, p);
282 return count;
284 end = strchr(p, delim);
285 if (end) {
286 string_list_append_nodup(list, xmemdupz(p, end - p));
287 p = end + 1;
288 } else {
289 string_list_append(list, p);
290 return count;
295 int string_list_split_in_place(struct string_list *list, char *string,
296 int delim, int maxsplit)
298 int count = 0;
299 char *p = string, *end;
301 if (list->strdup_strings)
302 die("internal error in string_list_split_in_place(): "
303 "list->strdup_strings must not be set");
304 for (;;) {
305 count++;
306 if (maxsplit >= 0 && count > maxsplit) {
307 string_list_append(list, p);
308 return count;
310 end = strchr(p, delim);
311 if (end) {
312 *end = '\0';
313 string_list_append(list, p);
314 p = end + 1;
315 } else {
316 string_list_append(list, p);
317 return count;