summaryrefslogtreecommitdiffstats
path: root/lib/glcontainers.h
blob: a60bf2e33d038929a53103ea1506bad300098335 (plain)
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
65
66
67
68
69
70
71
72
73
74
/*
 * glcontainers.h: interface to common Gnulib container helpers
 *
 * Copyright (C) 2019 Colin Watson.
 *
 * This file is part of man-db.
 *
 * man-db 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.
 *
 * man-db 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 man-db; if not, write to the Free Software Foundation,
 * Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
 */

#ifndef MAN_GLCONTAINERS_H
#define MAN_GLCONTAINERS_H

#include <stdbool.h>
#include <stdlib.h>

#include "gl_list.h"
#include "gl_map.h"
#include "gl_set.h"

/* These types are compatible with those required by Gnulib container
 * initialisation.
 */

bool string_equals (const void *s1, const void *s2);
size_t string_hash (const void *s);
void plain_free (const void *s);

/* Convenience functions. */

gl_list_t new_string_list (gl_list_implementation_t implementation,
			   bool allow_duplicates);
gl_map_t new_string_map (gl_map_implementation_t implementation,
			 gl_mapvalue_dispose_fn vdispose_fn);
gl_set_t new_string_set (gl_set_implementation_t implementation);

/* Iterator macros. */

#define GL_LIST_FOREACH_START(list, item) \
	do { \
		gl_list_iterator_t list##_iter = gl_list_iterator (list); \
		gl_list_node_t list##_node; \
		while (gl_list_iterator_next (&list##_iter, \
					      (const void **) &item, \
					      &list##_node))

#define GL_LIST_FOREACH_END(list) \
		gl_list_iterator_free (&list##_iter); \
	} while (0)

#define GL_MAP_FOREACH_START(map, key, value) \
	do { \
		gl_map_iterator_t map##_iter = gl_map_iterator (map); \
		while (gl_map_iterator_next (&map##_iter, \
					     (const void **) &key, \
					     (const void **) &value))

#define GL_MAP_FOREACH_END(map) \
		gl_map_iterator_free (&map##_iter); \
	} while (0)

#endif /* MAN_GLCONTAINERS_H */