init_string_builder

Prepares builder for use. Every other builder procedure does this for you, so the only reason to call it is to pick buffer_size, the size of the buffers added after the first (4 KiB by default). The builder takes the current context allocator. Calling it on a prepared builder does nothing.

init_string_builder :: (builder: *String_Builder, buffer_size := -1)

builder: String_Builder;
init_string_builder(*builder, 64 * 1024);
defer free_buffers(*builder);
append(*builder, "ready");
assert(builder_string_length(*builder) == 5);