WithCapacity

Creates a builder with space pre-allocated.

Module: Std

Signature

func WithCapacity(capacity: uint) -> StringBuilder;

Parameters

Name	Type	Description
capacity	uint	Number of bytes to allocate up front.

Returns

StringBuilder — an empty builder backed by a buffer of capacity bytes. A capacity of 0 behaves like New.

Description

Use WithCapacity when you can estimate the final size: it allocates the buffer once, so subsequent appends up to capacity won't trigger a reallocation. The builder still grows automatically if you exceed the reserved size.

Example

import Std::StringBuilder;

// Building a 16-row table — reserve once.
var sb = StringBuilder::WithCapacity(1024);

See also

• StringBuilder — the type
• New — start empty
• Reserve — grow capacity after construction