summaryrefslogtreecommitdiff
path: root/support/texlab/crates/bibutils_sys/src/vplist.h
blob: 9a1c7ba037249c8ef566a30a1a83b68d11c3d0c6 (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
75
76
77
78
79
80
81
82
83
84
85
86
/*
 * vplist.h
 *
 * generic container to hold a list of pointers to void
 *
 * Version: 1/9/2017
 *
 * Copyright (c) Chris Putnam 2011-2019
 *
 * Source code released under the GPL version 2
 *
 */

#ifndef VPLIST_H
#define VPLIST_H

#define VPLIST_MEMERR (-1)
#define VPLIST_OK     (0)

typedef int vplist_index;

typedef struct vplist {
	vplist_index n, max;
	void **data;
} vplist;

#define vplist_found( vpl, n ) ( n!=-1 )
#define vplist_notfound( vpl, n ) ( n==-1 )

typedef void (*vplist_ptrfree)(void*);

vplist *     vplist_new( void );

void   vplist_init          ( vplist *vpl );
int    vplist_add           ( vplist *vpl, void *v );
int    vplist_fill          ( vplist *vpl, vplist_index n, void *v );
int    vplist_copy          ( vplist *to,  vplist *from );
int    vplist_append        ( vplist *vpl, vplist *add );
int    vplist_insert_list   ( vplist *vpl, vplist_index pos, vplist *add );
void * vplist_get           ( vplist *vpl, vplist_index n );
void   vplist_set           ( vplist *vpl, vplist_index n, void *v );
void   vplist_swap          ( vplist *vpl, vplist_index n1, vplist_index n2 );
int    vplist_remove        ( vplist *vpl, vplist_index n );
int    vplist_removefn      ( vplist *vpl, vplist_index n, vplist_ptrfree vpf );
int    vplist_removevp      ( vplist *vpl, void *v );
int    vplist_removevpfn    ( vplist *vpl, void *v, vplist_ptrfree vpf );
void   vplist_remove_rangefn( vplist *vpl, vplist_index start, vplist_index endplusone, vplist_ptrfree vpf );
void   vplist_remove_range  ( vplist *vpl, vplist_index start, vplist_index endplusone );

vplist_index vplist_find( vplist *vpl, void *v );

/*
 * vplist_empty does not free space
 *
 * if members require their own free calls, then call vplist_emptyfn()
 *
 * void
 * member_free( void *v )
 * {
 *     member *m = ( member * ) v;
 *     member_free( m );
 *     free( m );
 * }
 * vplist_emptyfn( &vpl, member_free );
 *
 * if members are simply allocated with malloc(), then use free()
 *
 * vplist_emptyfn( &vpl, free );
 */
void   vplist_empty  ( vplist *vpl );
void   vplist_emptyfn( vplist *vpl, vplist_ptrfree fn );
/*
 * vplist_free frees the space for the data array of void * elements.
 *
 * if members require their own free calls, then call vplist_freefn()
 */
void vplist_free  ( vplist *vpl );
void vplist_freefn( vplist *vpl, vplist_ptrfree fn );
/*
 * vplist_delete does vplist_free and deallocates the struct
 * vplist * and replaces with NULL.
 */
void vplist_delete  ( vplist **vpl );
void vplist_deletefn( vplist **vpl, vplist_ptrfree fn );

#endif