bittystring

A C string library with short-string optimization. Supports short string up to 23 characters (22 + null terminator).

Examples

Heap Allocate

char *s = "Cool text";

bstr *bs = bstr_new();
bstr_append_cstring(bs, s, strlen(s));
printf("%s\n", bstr_cstring(bs));
bstr_free(bs);

Stack Allocate

char *s = "Cool text";

bstr bs;
bstr_init(&bs);
bstr_append_cstring(&bs, s, strlen(s));
printf("%s\n", bstr_cstring(&bs));
bstr_free_contents(&bs); // free not strictly necessary here because of short-string, but always a good idea

Caveats

bittystring uses the most-significant bit of uint64_t capacity to store the short-string flag. So the theoretical maximum capacity of a bstr is limited to 2^63 bytes.

bittystring is only designed for little-endian platforms.