use sb

StringBuilder - Efficient string building. Avoids O(n²) cost of repeated str::concat.

Functions

fn append_char

Append a single character (by code point).

Signature: (sb:ptr c:i64 -- sb:ptr)

Parameter Type Description
sb ptr Builder to append to
c i64 Character code to append
Output Type Description
sb ptr Updated builder

Example:

builder 65 sb::append_char  // builder

fn append_int

Append an integer as string.

Signature: (sb:ptr n:i64 -- sb:ptr)

Parameter Type Description
sb ptr Builder to append to
n i64 Integer to append
Output Type Description
sb ptr Updated builder

Example:

builder 42 sb::append_int  // builder

fn append

Append a string to the builder.

Signature: (sb:ptr s:str -- sb:ptr)

Parameter Type Description
sb ptr Builder to append to
s str String to append
Output Type Description
sb ptr Updated builder

Example:

builder "hello" sb::append  // builder

fn build

Build the final string (does not consume builder).

Signature: (sb:ptr -- s:str)

Parameter Type Description
sb ptr Builder to convert
Output Type Description
s str Built string

Example:

builder sb::build  // result

fn finish

Build string and free builder in one call.

Signature: (sb:ptr -- s:str)

Parameter Type Description
sb ptr Builder to finish
Output Type Description
s str Built string

Example:

builder sb::finish  // result

fn free

Free the builder's resources.

Signature: (sb:ptr -- )

Parameter Type Description
sb ptr Builder to free

Example:

builder sb::free

fn len

Get current length of builder content.

Signature: (sb:ptr -- sblen:i64)

Parameter Type Description
sb ptr Builder to check
Output Type Description
sblen i64 Current content length

Example:

builder sb::len  // sblen

fn new

Create a new StringBuilder with default capacity.

Signature: ( -- sb:ptr)

Output Type Description
sb ptr New empty builder

Example:

sb::new  // builder

fn with_capacity

Create a StringBuilder with specific initial capacity.

Signature: (capacity:i64 -- sb:ptr)

Parameter Type Description
capacity i64 Initial buffer size
Output Type Description
sb ptr New empty builder

Example:

1024 sb::with_capacity  // builder

StringBuilder

Growable string buffer for efficient string building.

Struct

Field Type Description
buf ptr Internal buffer
len i64 Current length
cap i64 Buffer capacity