Add dynamically-sized strings.

1 files changed, 36 insertions, 1 deletions

diff --git a/cstring/include/cstring.h b/cstring/include/cstring.h
index 134e68e..a3f6b3f 100644
--- a/cstring/include/cstring.h
+++ b/cstring/include/cstring.h
@@ -1,12 +1,16 @@
 /// Fixed-size strings with value semantics.
 #pragma once
 
-#include <bsd/string.h>
 #include <cassert.h>
+
+#include <bsd/string.h>
 #include <stdbool.h>
 #include <stdint.h>
 #include <stdio.h>
 
+// -----------------------------------------------------------------------------
+// Fix-sized strings.
+
 /// A fixed-size string.
 /// The string is null-terminated so that it can be used with the usual C APIs.
 #define DEF_STRING(STRING, SIZE)                                          \
@@ -118,3 +122,34 @@ DEF_STRING(sstring, 32)    // Small.
 DEF_STRING(mstring, 256)   // Medium.
 DEF_STRING(lstring, 1024)  // Large.
 DEF_STRING(xlstring, 4096) // Extra large.
+
+// -----------------------------------------------------------------------------
+// Dynamically-sized strings.
+
+typedef struct string {
+  const char* data;
+  size_t      length;
+} string;
+
+/// Create a new string.
+string string_new(const char*);
+
+/// Delete the string.
+void string_del(string*);
+
+/// Get the string's length.
+static inline size_t string_length(const string str) { return str.length; }
+
+/// Get the string's data.
+static inline const char* string_data(const string str) { return str.data; }
+
+/// Concatenate two strings.
+string string_concat(string left, string right);
+
+/// Convert a size to string.
+string string_from_size(size_t);
+
+/// Convert and format a size to string.
+/// The result uses B for bytes, K for kilobytes (1024), M for megabytes
+/// (2**20), and G for gigabytes (2**30), with two decimal digits.
+string string_format_size(size_t);