2 list.h -- header file for list.c
3 Copyright (C) 2000-2005 Ivo Timmermans
4 2000-2006 Guus Sliepen <guus@tinc-vpn.org>
6 This program is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 2 of the License, or
9 (at your option) any later version.
11 This program is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License along
17 with this program; if not, write to the Free Software Foundation, Inc.,
18 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
21 #ifndef __TINC_LIST_H__
22 #define __TINC_LIST_H__
24 typedef struct list_node_t {
25 struct list_node_t *prev;
26 struct list_node_t *next;
33 typedef void (*list_action_t)(const void *);
34 typedef void (*list_action_node_t)(const list_node_t *);
36 typedef struct list_t {
46 /* (De)constructors */
48 extern list_t *list_alloc(list_action_t) __attribute__ ((__malloc__));
49 extern void list_free(list_t *);
50 extern list_node_t *list_alloc_node(void);
51 extern void list_free_node(list_t *, list_node_t *);
53 /* Insertion and deletion */
55 extern list_node_t *list_insert_head(list_t *, void *);
56 extern list_node_t *list_insert_tail(list_t *, void *);
57 extern list_node_t *list_insert_after(list_t *, list_node_t *, void *);
58 extern list_node_t *list_insert_before(list_t *, list_node_t *, void *);
60 extern void list_unlink_node(list_t *, list_node_t *);
61 extern void list_delete_node(list_t *, list_node_t *);
63 extern void list_delete_head(list_t *);
64 extern void list_delete_tail(list_t *);
66 /* Head/tail lookup */
68 extern void *list_get_head(list_t *);
69 extern void *list_get_tail(list_t *);
71 /* Fast list deletion */
73 extern void list_delete_list(list_t *);
77 extern void list_foreach(list_t *, list_action_t);
78 extern void list_foreach_node(list_t *, list_action_node_t);
80 #endif /* __TINC_LIST_H__ */