A classical dynamic array of charactors inspired by both Tsoding's String Builder and Golang's String Builder.
To constuct a new string builder object, you will need to call the sring_builder_init function. This will return a heap allocated string builder object.
To append to the string builder, there are two methods you can call: string_builder_append or string_builder_extend. string_builder_append takes in the object and a charactor to append. string_builder_extend takes in the object and a null-terminated c-string to append — charactor by charactor — to the object. Like any other classical dynamic array, if the capacity is reached, the array is reallocated. If the reallocation fails, and error is raised.
There are two ways to access data within the array: string_builder_at and string_builder_data. string_builder_at will take in an index and returns a pointer to a charactor with the array at said index. If either, the index is greater than the size of the array, or there is no data at the index and error is raised. string_builder_data returns the full array. This function appends a null byte to the array before returning. It internally calls string_builder_append function so all errors pertaining to that function still apply.
To copy the array to another string builder object, you will need to call the string_builder_combine function. This will take in a view to the original string builder and a destination string builder to which to append.
To deallocate the string builder object, you will need to call the string_builder_delete function.