StringChunk

Object Hierarchy:

Description:

[ Compact ]
[ CCode ( free_function = "g_string_chunk_free" ) ]
public class StringChunk

`GStringChunk` provides efficient storage of groups of strings

String chunks are used to store groups of strings. Memory is allocated in blocks, and as strings are added to the `GStringChunk` they are copied into the next free position in a block. When a block is full a new block is allocated.

When storing a large number of strings, string chunks are more efficient than using [func@GLib.strdup] since fewer calls to `malloc()` are needed, and less memory is wasted in memory allocation overheads.

By adding strings with [method@GLib.StringChunk.insert_const] it is also possible to remove duplicates.

To create a new `GStringChunk` use [func@GLib.StringChunk.new].

To add strings to a `GStringChunk` use [method@GLib.StringChunk.insert].

To add strings to a `GStringChunk`, but without duplicating strings which are already in the `GStringChunk`, use [ method@GLib.StringChunk.insert_const].

To free the entire `GStringChunk` use [method@GLib.StringChunk.free]. It is not possible to free individual strings.

Namespace: GLib

Package: glib-2.0

Content:

Creation methods:

public StringChunk (size_t size)

Methods:

public void clear ()
Frees all strings contained within the StringChunk .
public unowned string insert (string str)
Adds a copy of string to the StringChunk .
public unowned string insert_const (string str)
Adds a copy of string to the StringChunk , unless the same string has already been added to the StringChunk with insert_const .
public unowned string insert_len (string str, ssize_t len)
Adds a copy of the first len bytes of string to the StringChunk.