NAME

src/pmc/stringbuilder.pmc - StringBuilder PMC

DESCRIPTION

Helper class to create and manipulate strings, which are outside of StringBuilder immutable.

Methods

void init()

Initializes the StringBuilder.

void init_int()

Initializes the StringBuilder with initial size of buffer.

void init_pmc()

Initializes the StringBuilder with an array of STRINGs.

void mark()

Mark the buffer.

STRING *get_string()

Returns created string.

STRING *push_string()

Append string to current buffer.

VTABLE i_concatenate_str()

VTABLE i_concatenate()

Append string. Synonym for push_string

VTABLE set_string_native(STRING)

VTABLE set_pmc(PMC)

Set content of buffer to passed string or PMC

VTABLE get_integer()

Returns current capacity of allocated buffer.For testing purpose only?

VTABLE substr()

Returns a copied substring of the STRING.

append_format(string fmt [, pmc args ] [, pmc hash ])

Add a line to a StringBuilder object according to fmt. The fmt string can contain any number of "%-replacements" which are replaced by the corresponding values from args or hash prior to being appended to the string. (Here args is a slurpy array, and hash is a slurpy hash.)The currently defined replacements include:

    %0 %1 ... %9     the value from the args array at index 0..9
    %,               the values of the args array separated by commas
    %%               a percent sign

A percent-sign followed by any other character that is a hash key receives the value of the hash element.

INTVAL get_string_length()

Returns length of currently built string.

Helper functions.

static size_t calculate_capacity(PARROT_INTERP, size_t needed)

Calculate capacity for string. We overallocate by 2 for smaller buffers resp. onto the next block size.

static void convert_encoding(PARROT_INTERP, STR_VTABLE *dest_encoding, STRING *buffer, size_t size_to_add)

Convert buffer content to the encoding specified and increase its size, reallocating it if needed.