mirror of https://github.com/merbanan/rtl_433.git
45 lines
1.5 KiB
C
45 lines
1.5 KiB
C
/** @file
|
|
Generic list.
|
|
|
|
Copyright (C) 2018 Christian Zuckschwerdt
|
|
|
|
This program 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.
|
|
*/
|
|
|
|
#ifndef INCLUDE_LIST_H_
|
|
#define INCLUDE_LIST_H_
|
|
|
|
#include <stddef.h>
|
|
|
|
/// Dynamically growing list, elems is always NULL terminated, call list_ensure_size() to alloc elems.
|
|
typedef struct list {
|
|
void **elems;
|
|
size_t size;
|
|
size_t len;
|
|
} list_t;
|
|
|
|
typedef void (*list_elem_free_fn)(void *);
|
|
|
|
/// Alloc elems if needed and ensure the list has room for at least min_size elements.
|
|
void list_ensure_size(list_t *list, size_t min_size);
|
|
|
|
/// Add to the end of elems, allocs or grows the list if needed and ensures the list has a terminating NULL.
|
|
void list_push(list_t *list, void *p);
|
|
|
|
/// Adds all elements of a NULL terminated list to the end of elems, allocs or grows the list if needed and ensures the list has a terminating NULL.
|
|
void list_push_all(list_t *list, void **p);
|
|
|
|
/// Remove element from the list, frees element with fn.
|
|
void list_remove(list_t *list, size_t idx, list_elem_free_fn elem_free);
|
|
|
|
/// Clear the list, frees each element with fn, does not free backing or list itself.
|
|
void list_clear(list_t *list, list_elem_free_fn elem_free);
|
|
|
|
/// Clear the list, free backing, does not free list itself.
|
|
void list_free_elems(list_t *list, list_elem_free_fn elem_free);
|
|
|
|
#endif /* INCLUDE_LIST_H_ */
|