Function BasicString.reserve
Requests that the string capacity be adapted to a planned change in size to a length of up to n characters (utf code units).
void reserve
(
const size_t n
) scope;
If n is greater than the current string capacity, the function causes the container to increase its capacity to n characters (or greater).
In all other cases, it do nothing.
This function has no effect on the string length and cannot alter its content.
Examples
BasicString!char str = "123";
assert(str .capacity == BasicString!char .minimalCapacity);
const size_t cap = (str .capacity * 2);
str .reserve(cap);
assert(str .capacity > BasicString!char .minimalCapacity);
assert(str .capacity >= cap);