capacity

Returns the allocated buffer capacity in bytes.

Example:

    var sb = new StringBuilder.sized (256);
    assert (sb.capacity () >= 256);

Returns:

the buffer capacity.