ClangFormat: apply to source, most of intern
[blender.git] / source / blender / blenlib / BLI_heap.h
1 /*
2  * This program is free software; you can redistribute it and/or
3  * modify it under the terms of the GNU General Public License
4  * as published by the Free Software Foundation; either version 2
5  * of the License, or (at your option) any later version.
6  *
7  * This program is distributed in the hope that it will be useful,
8  * but WITHOUT ANY WARRANTY; without even the implied warranty of
9  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
10  * GNU General Public License for more details.
11  *
12  * You should have received a copy of the GNU General Public License
13  * along with this program; if not, write to the Free Software Foundation,
14  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
15  */
16
17 #ifndef __BLI_HEAP_H__
18 #define __BLI_HEAP_H__
19
20 /** \file
21  * \ingroup bli
22  * \brief A min-heap / priority queue ADT
23  */
24
25 struct Heap;
26 struct HeapNode;
27 typedef struct Heap Heap;
28 typedef struct HeapNode HeapNode;
29
30 typedef void (*HeapFreeFP)(void *ptr);
31
32 Heap *BLI_heap_new_ex(unsigned int tot_reserve) ATTR_WARN_UNUSED_RESULT;
33 Heap *BLI_heap_new(void) ATTR_WARN_UNUSED_RESULT;
34 void BLI_heap_clear(Heap *heap, HeapFreeFP ptrfreefp) ATTR_NONNULL(1);
35 void BLI_heap_free(Heap *heap, HeapFreeFP ptrfreefp) ATTR_NONNULL(1);
36 HeapNode *BLI_heap_insert(Heap *heap, float value, void *ptr) ATTR_NONNULL(1);
37 void BLI_heap_insert_or_update(Heap *heap, HeapNode **node_p, float value, void *ptr)
38     ATTR_NONNULL(1, 2);
39 void BLI_heap_remove(Heap *heap, HeapNode *node) ATTR_NONNULL(1, 2);
40 bool BLI_heap_is_empty(const Heap *heap) ATTR_NONNULL(1);
41 unsigned int BLI_heap_len(const Heap *heap) ATTR_WARN_UNUSED_RESULT ATTR_NONNULL(1);
42 HeapNode *BLI_heap_top(const Heap *heap) ATTR_WARN_UNUSED_RESULT ATTR_NONNULL(1);
43 float BLI_heap_top_value(const Heap *heap) ATTR_WARN_UNUSED_RESULT ATTR_NONNULL(1);
44 void *BLI_heap_pop_min(Heap *heap) ATTR_NONNULL(1);
45 void BLI_heap_node_value_update(Heap *heap, HeapNode *node, float value) ATTR_NONNULL(1, 2);
46 void BLI_heap_node_value_update_ptr(Heap *heap, HeapNode *node, float value, void *ptr)
47     ATTR_NONNULL(1, 2);
48
49 /* Return the value or pointer of a heap node. */
50 float BLI_heap_node_value(const HeapNode *heap) ATTR_WARN_UNUSED_RESULT ATTR_NONNULL(1);
51 void *BLI_heap_node_ptr(const HeapNode *heap) ATTR_WARN_UNUSED_RESULT ATTR_NONNULL(1);
52 /* only for gtest */
53 bool BLI_heap_is_valid(const Heap *heap);
54
55 #endif /* __BLI_HEAP_H__ */