1/*	$Id: dba_array.h,v 1.1 2016/07/19 21:31:55 schwarze Exp $ */
2/*
3 * Copyright (c) 2016 Ingo Schwarze <schwarze@openbsd.org>
4 *
5 * Permission to use, copy, modify, and distribute this software for any
6 * purpose with or without fee is hereby granted, provided that the above
7 * copyright notice and this permission notice appear in all copies.
8 *
9 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
10 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
11 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
12 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
13 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
14 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
15 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
16 *
17 * Public interface for allocation-based arrays
18 * for the mandoc database, for read-write access.
19 * To be used by dba*.c and by makewhatis(8).
20 */
21
22struct dba_array;
23
24#define	DBA_STR		0x01	/* Map contains strings, not pointers. */
25#define	DBA_GROW	0x02	/* Allow the array to grow. */
26
27#define	dba_array_FOREACH(a, e) \
28	dba_array_start(a); \
29	while (((e) = dba_array_next(a)) != NULL)
30
31typedef int dba_compare_func(const void *, const void *);
32
33struct dba_array *dba_array_new(int32_t, int);
34void		 dba_array_free(struct dba_array *);
35void		 dba_array_set(struct dba_array *, int32_t, void *);
36void		 dba_array_add(struct dba_array *, void *);
37void		*dba_array_get(struct dba_array *, int32_t);
38void		 dba_array_start(struct dba_array *);
39void		*dba_array_next(struct dba_array *);
40void		 dba_array_del(struct dba_array *);
41void		 dba_array_undel(struct dba_array *);
42void		 dba_array_setpos(struct dba_array *, int32_t, int32_t);
43int32_t		 dba_array_getpos(struct dba_array *);
44void		 dba_array_sort(struct dba_array *, dba_compare_func);
45int32_t		 dba_array_writelen(struct dba_array *, int32_t);
46void		 dba_array_writepos(struct dba_array *);
47void		 dba_array_writelst(struct dba_array *);
48