ci2_mem

2026-06-25 20:04:47 -05:00
parent b0ef24be91
commit c76bc6da90
4 changed files with 243 additions and 0 deletions
@@ -0,0 +1,62 @@
+/* - | Copyright / About | ----------------------------------------------------
+   Copyright (c) 2026 Randy Jordan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+This is the ci2_mem.h interface. They all are just wrappers for the general
+stdlib allocators. If they fail they raise an exception with macro magic. All
+other functions that may raise an exception are in include/platform/try. It's
+not recommended to use these functions, as they are hard to debug and it's not
+a robust way to handle errors.
+
+ * --------------------------------------------------------------------------*/
+#ifndef CI2_MEM_H
+#define CI2_MEM_H
+
+#include "../ci2_platform.h"        // Exceptions
+#include "../error/ci2_exception.h" // Exceptions
+#include <stddef.h>                 // size_t
+
+CI2_DEF const struct Exception oom; // Out of memory
+
+CI2_DEF void*
+ci2_alloc(size_t nbytes, const char* file, int line);
+
+CI2_DEF void*
+ci2_calloc(size_t count, size_t nbytes, const char* file, int line);
+
+CI2_DEF void
+ci2_free(void* ptr, const char* file, int line);
+
+CI2_DEF void*
+ci2_resize(void* ptr, size_t nbytes, const char* file, int line);
+
+#define CI2_ALLOC(nbytes) ci2_alloc((nbytes), __FILE__, __LINE__)
+#define CI2_CALLOC(count, nbytes)                                              \
+  ci2_calloc((count), (nbytes), __FILE__, __LINE__)
+
+#define CI2_NEW(p) ((p) = CI2_ALLOC((size_t)sizeof *(p)))
+#define CI2_NEW0(p) ((p) = CI2_CALLOC(1, (size_t)sizeof *(p)))
+
+#define CI2_FREE(ptr) ((void)(ci2_free((ptr), __FILE__, __LINE__), (ptr) = 0))
+
+#define CI2_RESIZE(ptr, nbytes)                                                \
+  ((ptr) = ci2_resize((ptr), (nbytes), __FILE__, __LINE__))
+
+#endif // ci2_mem.h