| Wireshark 4.7.0 The Wireshark network protocol analyzer

Loading...
Searching...
No Matches
wmem_array.h
Go to the documentation of this file.
1
12#ifndef __WMEM_ARRAY_H__
13#define __WMEM_ARRAY_H__
14
15#include <string.h>
16#include <glib.h>
17
18#include "wmem_core.h"
19
20#ifdef __cplusplus
21 extern "C" {
22#endif /* __cplusplus */
23
33 struct _wmem_array_t;
34
42 typedef struct _wmem_array_t wmem_array_t;
43
56WS_DLL_PUBLIC
57 wmem_array_t *
58 wmem_array_sized_new(wmem_allocator_t *allocator, size_t elem_size,
59 unsigned alloc_count);
60
71WS_DLL_PUBLIC
72 wmem_array_t *
73 wmem_array_new(wmem_allocator_t *allocator, const size_t elem_size);
74
84WS_DLL_PUBLIC
85 void
86 wmem_array_grow(wmem_array_t *array, const unsigned to_add);
87
97WS_DLL_PUBLIC
98 void
99 wmem_array_set_null_terminator(wmem_array_t *array);
100
108WS_DLL_PUBLIC
109 void
110 wmem_array_bzero(wmem_array_t *array);
111
122WS_DLL_PUBLIC
123 void
124 wmem_array_append(wmem_array_t *array, const void *in, unsigned count);
125
135#define wmem_array_append_one(ARRAY, VAL) \
136 wmem_array_append((ARRAY), &(VAL), 1)
137
149WS_DLL_PUBLIC
150 void *
151 wmem_array_index(const wmem_array_t *array, unsigned array_index);
152
165WS_DLL_PUBLIC
166 int
167 wmem_array_try_index(const wmem_array_t *array, unsigned array_index, void *val);
168
180WS_DLL_PUBLIC
181 void
182 wmem_array_sort(wmem_array_t *array, int (*compar)(const void*,const void*));
183
193WS_DLL_PUBLIC
194 void *
195 wmem_array_get_raw(const wmem_array_t *array);
196
206WS_DLL_PUBLIC
207 unsigned
208 wmem_array_get_count(const wmem_array_t *array);
209
219WS_DLL_PUBLIC
220 wmem_allocator_t*
221 wmem_array_get_allocator(const wmem_array_t* array);
222
238WS_DLL_PUBLIC
239 void *
240 wmem_array_finalize(wmem_array_t *array);
241
251WS_DLL_PUBLIC
252 void
253 wmem_destroy_array(wmem_array_t *array);
254
258#ifdef __cplusplus
259}
260#endif /* __cplusplus */
261
262#endif /* __WMEM_ARRAY_H__ */
263
264/*
265 * Editor modelines - https://www.wireshark.org/tools/modelines.html
266 *
267 * Local variables:
268 * c-basic-offset: 4
269 * tab-width: 8
270 * indent-tabs-mode: nil
271 * End:
272 *
273 * vi: set shiftwidth=4 tabstop=8 expandtab:
274 * :indentSize=4:tabSize=8:noTabs=true:
275 */
wmem_array_get_allocator
WS_DLL_PUBLIC wmem_allocator_t * wmem_array_get_allocator(const wmem_array_t *array)
Retrieve the memory allocator associated with a dynamic array.
Definition wmem_array.c:165
wmem_array_new
WS_DLL_PUBLIC wmem_array_t * wmem_array_new(wmem_allocator_t *allocator, const size_t elem_size)
Create a new dynamically sized array with default initial capacity.
Definition wmem_array.c:61
wmem_destroy_array
WS_DLL_PUBLIC void wmem_destroy_array(wmem_array_t *array)
Destroy a dynamic array and free its associated memory.
Definition wmem_array.c:188
wmem_array_index
WS_DLL_PUBLIC void * wmem_array_index(const wmem_array_t *array, unsigned array_index)
Retrieve a pointer to an element in a dynamic array by index.
Definition wmem_array.c:128
wmem_array_bzero
WS_DLL_PUBLIC void wmem_array_bzero(wmem_array_t *array)
Zero out the contents of a dynamic array.
Definition wmem_array.c:109
wmem_array_get_count
WS_DLL_PUBLIC unsigned wmem_array_get_count(const wmem_array_t *array)
Get the number of elements currently stored in a dynamic array.
Definition wmem_array.c:156
wmem_array_get_raw
WS_DLL_PUBLIC void * wmem_array_get_raw(const wmem_array_t *array)
Retrieve a raw pointer to the internal buffer of a dynamic array.
Definition wmem_array.c:150
wmem_array_sized_new
WS_DLL_PUBLIC wmem_array_t * wmem_array_sized_new(wmem_allocator_t *allocator, size_t elem_size, unsigned alloc_count)
Create a new dynamically sized array with a specified element size and initial capacity.
Definition wmem_array.c:41
wmem_array_grow
WS_DLL_PUBLIC void wmem_array_grow(wmem_array_t *array, const unsigned to_add)
Increase the capacity of a dynamic array by a specified number of elements.
Definition wmem_array.c:71
wmem_array_try_index
WS_DLL_PUBLIC int wmem_array_try_index(const wmem_array_t *array, unsigned array_index, void *val)
Safely retrieve an element from a dynamic array by index.
Definition wmem_array.c:135
wmem_array_sort
WS_DLL_PUBLIC void wmem_array_sort(wmem_array_t *array, int(*compar)(const void *, const void *))
Sort the elements of a dynamic array.
Definition wmem_array.c:144
wmem_array_set_null_terminator
WS_DLL_PUBLIC void wmem_array_set_null_terminator(wmem_array_t *array)
Set a null terminator at the end of a dynamic array.
Definition wmem_array.c:102
wmem_array_finalize
WS_DLL_PUBLIC void * wmem_array_finalize(wmem_array_t *array)
Finalize a dynamic array and retrieve its underlying buffer.
Definition wmem_array.c:174
wmem_array_append
WS_DLL_PUBLIC void wmem_array_append(wmem_array_t *array, const void *in, unsigned count)
Append elements to a dynamic array.
Definition wmem_array.c:115
_wmem_allocator_t
Internal memory allocator interface used by the wmem subsystem.
Definition wmem_allocator.h:34
_wmem_array_t
Definition wmem_array.c:27
wmem_core.h