StringBuilder

StringBuilder

Object Hierarchy:

Description:

public class StringBuilder

A StringBuilder is an object that handles the memory management of a C string for you.

In addition to the string itself, StringBuilder stores the length of the string, so can be used for binary data with embedded nul bytes. To access the C string managed by the StringBuilder string, simply use StringBuilder.str.

Namespace: GLib

Package: glib-2.0

Content:

Creation methods:

public StringBuilder (string init = "")
Creates a new StringBuilder, initialized with the given string.
public StringBuilder.sized (size_t dfl_size)
Creates a new StringBuilder, with enough space for dfl_size bytes.

Methods:

public unowned StringBuilder assign (string rval)
Copies the bytes from a string into a StringBuilder, destroying any previous contents.
public unowned StringBuilder append (string val)
Adds a string onto the end of a StringBuilder, expanding it if necessary.
public unowned StringBuilder append_c (char c)
Adds a byte onto the end of a StringBuilder, expanding it if necessary.
public unowned StringBuilder append_unichar (unichar wc)
Converts a Unicode character into UTF-8, and appends it to the string.
public unowned StringBuilder append_len (string val, ssize_t len)
Appends len bytes of val to string.
public unowned StringBuilder prepend (string val)
Adds a string on to the start of a StringBuilder, expanding it if necessary.
public unowned StringBuilder prepend_c (char c)
Adds a byte onto the start of a StringBuilder, expanding it if necessary.
public unowned StringBuilder prepend_unichar (unichar wc)
Converts a Unicode character into UTF-8, and prepends it to the string.
public unowned StringBuilder prepend_len (string val, ssize_t len)
Prepends len bytes of val to string. Because len is provided, val may contain embedded nuls and need not be nul-terminated.
public unowned StringBuilder insert (ssize_t pos, string val)
Inserts a copy of a string into a StringBuilder, expanding it if necessary.
public unowned StringBuilder insert_unichar (ssize_t pos, unichar wc)
Converts a Unicode character into UTF-8, and insert it into the string at the given position.
public unowned StringBuilder erase (ssize_t pos = 0, ssize_t len = -1)
Removes len bytes from a StringBuilder, starting at position pos. The rest of the StringBuilder is shifted down to fill the gap.
public unowned StringBuilder truncate (size_t len = 0)
Cuts off the end of the StringBuilder, leaving the first len bytes.
public void printf (string format, ...)
Writes a formatted string into a StringBuilder.
public void append_printf (string format, ...)
Appends a formatted string onto the end of a StringBuilder.
public void vprintf (string format, va_list args)
Writes a formatted string into a StringBuilder.
public void append_vprintf (string format, va_list args)
Appends a formatted string onto the end of a StringBuilder.

Fields:

public string str
public ssize_t len
public ssize_t allocated_len