GLib.StringChunk
Description: Reference for GLib.StringChunk

### Struct

# GLibStringChunk

#### Description [src]

    struct GStringChunk {
      /* No available fields */
    }

`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 `g_strdup()` since fewer calls to `malloc()` are needed, and less memory is wasted in memory allocation overheads.

By adding strings with `g_string_chunk_insert_const()` it is also possible to remove duplicates.

To create a new `GStringChunk` use `g_string_chunk_new()`.

To add strings to a `GStringChunk` use `g_string_chunk_insert()`.

To add strings to a `GStringChunk`, but without duplicating strings which are already in the `GStringChunk`, use `g_string_chunk_insert_const()`.

To free the entire `GStringChunk` use `g_string_chunk_free()`. It is not possible to free individual strings.

#### Functions

###### g_string_chunk_new

Creates a new `GStringChunk`.

#### Instance methods

###### g_string_chunk_clear

Frees all strings contained within the `GStringChunk`. After calling `g_string_chunk_clear()` it is not safe to access any of the strings which were contained within it.

since: 2.14

###### g_string_chunk_free

Frees all memory allocated by the `GStringChunk`. After calling `g_string_chunk_free()` it is not safe to access any of the strings which were contained within it.

###### g_string_chunk_insert

Adds a copy of `string` to the `GStringChunk`. It returns a pointer to the new copy of the string in the `GStringChunk`. The characters in the string can be changed, if necessary, though you should not change anything after the end of the string.

###### g_string_chunk_insert_const

Adds a copy of `string` to the `GStringChunk`, unless the same string has already been added to the `GStringChunk` with g_string_chunk_insert_const().

###### g_string_chunk_insert_len

Adds a copy of the first `len` bytes of `string` to the `GStringChunk`. The copy is nul-terminated.

since: 2.4