MINOR: ist: Add `struct ist istalloc(size_t)` and `void istfree(struct ist*)`
`istalloc` allocates memory and returns an `ist` with the size `0` that points
to this allocation.
`istfree` frees the pointed memory and clears the pointer.
diff --git a/include/common/ist.h b/include/common/ist.h
index aa25a1f..db31544 100644
--- a/include/common/ist.h
+++ b/include/common/ist.h
@@ -32,6 +32,10 @@
#include <string.h>
#include <unistd.h>
+#ifndef IST_FREESTANDING
+#include <stdlib.h>
+#endif
+
#include <common/config.h>
/* ASCII to lower case conversion table */
@@ -729,4 +733,29 @@
;
return ist2(ist.ptr, len - 1);
}
+
+#ifndef IST_FREESTANDING
+/* This function allocates <size> bytes and returns an `ist` pointing to
+ * the allocated area with size `0`.
+ *
+ * If this function fails to allocate memory the return value is equivalent
+ * to IST_NULL.
+ */
+static inline struct ist istalloc(const size_t size)
+{
+ return ist2(malloc(size), 0);
+}
+
+/* This function performs the equivalent of free() on the given <ist>.
+ *
+ * After this function returns the value of the given <ist> will be
+ * modified to be equivalent to IST_NULL.
+ */
+static inline void istfree(struct ist *ist)
+{
+ free(ist->ptr);
+ *ist = IST_NULL;
+}
+#endif
+
#endif