1NE_MALLOC(3) neon API reference NE_MALLOC(3)
2
3
4
6 ne_malloc, ne_calloc, ne_realloc, ne_strdup, ne_strndup,
7 ne_oom_callback - memory allocation wrappers
8
10 #include <ne_alloc.h>
11
12 void *ne_malloc(size_t size);
13
14 void *ne_calloc(size_t size);
15
16 void *ne_realloc(void *size, size_t len);
17
18 char *ne_strdup(const char *s);
19
20 char *ne_strndup(const char *s, size_t size);
21
22 void ne_oom_callback(void (*callback)(void));
23
25 The functions ne_malloc, ne_calloc, ne_realloc, ne_strdup and
26 ne_strdnup provide wrappers for the equivalent functions in the
27 standard C library. The wrappers provide the extra guarantee that if
28 the C library equivalent returns NULL when no memory is available, an
29 optional callback will be called, and the library will then call
30 abort().
31
32 ne_oom_callback registers a callback which will be invoked if an out of
33 memory error is detected.
34
36 If the operating system uses optimistic memory allocation, the C
37 library memory allocation routines will not return NULL, so it is not
38 possible to gracefully handle memory allocation failures.
39
41 Joe Orton
42 Author.
43
45neon 0.32.5 21 January 2023 NE_MALLOC(3)