Initial version of struct DStr

include/ucore/dstr.h

@@ -0,0 +1,75 @@
+#ifndef UC_DSTR_H_
+#define UC_DSTR_H_
+
+#include <stddef.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/** A dynamic string.
+ * The string might not always be nul terminated,
+ * Normally, use uc_dstr_str() to manipulate the managed string
+ * instead of accessing ->str directly.
+ */
+struct DStr {
+    size_t len;
+    size_t allocated;
+    char *str;
+};
+
+#define UC_DSTR_STATIC_INIT {0, 0, NULL}
+
+/** Initialize a DStr.
+ * Note that str->str will be NULL after initialization.
+ *
+ */
+void uc_dstr_init(struct DStr *str);
+
+/** Destroy/free the string. 
+ * (Does not free str itself, only the managed resource of the str)
+ */
+void uc_dstr_destroy(struct DStr *str);
+
+/**
+ * @return the available/unused tail bytes in the string
+ */
+size_t uc_dstr_available(const struct DStr *str);
+
+/** Ensure the DStr is of at least 'len' bytes,
+ * allocating room if needed. 
+ */
+int uc_dstr_ensure(struct DStr *str, size_t len);
+
+void uc_dstr_reset(struct DStr *str);
+
+void uc_dstr_terminate(struct DStr *str);
+
+char *uc_dstr_str(struct DStr *str);
+
+char *uc_dstr_put(struct DStr *str, size_t len);
+
+size_t uc_dstr_put_str_filter(struct DStr *str, const char *s, int (*is_x)(int c));
+
+int uc_dstr_put_str_sz(struct DStr *str, const char *s, size_t len);
+
+int uc_dstr_put_str(struct DStr *str, const char *s);
+
+int uc_dstr_put_char(struct DStr *str, char c);
+
+void uc_dstr_own(struct DStr *str, char *s);
+
+char *uc_dstr_steal(struct DStr *str);
+
+void uc_str_swap(struct DStr *a, struct DStr *b);
+
+size_t uc_dstr_replace(struct DStr *str, char f, char r);
+
+void uc_dstr_trim(struct DStr *str);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif
+