#include <glib.h> struct GStringChunk; GStringChunk* g_string_chunk_new (gint size); gchar* g_string_chunk_insert (GStringChunk *chunk, const gchar *string); gchar* g_string_chunk_insert_const (GStringChunk *chunk, const gchar *string); void g_string_chunk_free (GStringChunk *chunk);
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.
An opaque data structure representing String Chunks. It should only be accessed by using the following functions.
GStringChunk* g_string_chunk_new (gint size);
Creates a new GStringChunk.
|size :||the default size of the blocks of memory which are allocated to store the strings. If a particular string is larger than this default size, a larger block of memory will be allocated for it.|
|Returns :||a new GStringChunk.|
gchar* g_string_chunk_insert (GStringChunk *chunk, const gchar *string);
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.
Unlike g_string_chunk_insert_const(), this function does not check for duplicates. Also strings added with g_string_chunk_insert() will not be searched by g_string_chunk_insert_const() when looking for duplicates.
gchar* g_string_chunk_insert_const (GStringChunk *chunk, const gchar *string);
This function is useful if you need to copy a large number of strings but do not want to waste space storing duplicates. But you must remember that there may be several pointers to the same string, and so any changes made to the strings should be done very carefully.