mirror of
https://gitlab.gnome.org/GNOME/glib.git
synced 2025-03-14 19:55:12 +01:00
docs: Move the GStringChunk SECTION
Move the contents to the struct docs. Helps: #3037
This commit is contained in:
parent
57219c14a0
commit
5a2a0aeaf9
@ -42,40 +42,33 @@
|
|||||||
#include "gutilsprivate.h"
|
#include "gutilsprivate.h"
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* SECTION:string_chunks
|
* GStringChunk:
|
||||||
* @title: String Chunks
|
*
|
||||||
* @short_description: efficient storage of groups of strings
|
* `GStringChunk` provides efficient storage of groups of strings
|
||||||
*
|
*
|
||||||
* String chunks are used to store groups of strings. Memory is
|
* String chunks are used to store groups of strings. Memory is
|
||||||
* allocated in blocks, and as strings are added to the #GStringChunk
|
* 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
|
* they are copied into the next free position in a block. When a block
|
||||||
* is full a new block is allocated.
|
* is full a new block is allocated.
|
||||||
*
|
*
|
||||||
* When storing a large number of strings, string chunks are more
|
* When storing a large number of strings, string chunks are more
|
||||||
* efficient than using g_strdup() since fewer calls to malloc() are
|
* efficient than using [func@g_strdup] since fewer calls to `malloc()`
|
||||||
* needed, and less memory is wasted in memory allocation overheads.
|
* are needed, and less memory is wasted in memory allocation overheads.
|
||||||
*
|
*
|
||||||
* By adding strings with g_string_chunk_insert_const() it is also
|
* By adding strings with [method@GLib.StringChunk.insert_const] it is also
|
||||||
* possible to remove duplicates.
|
* possible to remove duplicates.
|
||||||
*
|
*
|
||||||
* To create a new #GStringChunk use g_string_chunk_new().
|
* To create a new `GStringChunk` use [method@GLib.StringChunk.new].
|
||||||
*
|
*
|
||||||
* To add strings to a #GStringChunk use g_string_chunk_insert().
|
* To add strings to a `GStringChunk` use [method@GLib.Stringchunk.insert].
|
||||||
*
|
*
|
||||||
* To add strings to a #GStringChunk, but without duplicating strings
|
* To add strings to a `GStringChunk`, but without duplicating strings
|
||||||
* which are already in the #GStringChunk, use
|
* which are already in the `GStringChunk`, use [method@GLib.StringChunk.insert_const].
|
||||||
* g_string_chunk_insert_const().
|
|
||||||
*
|
*
|
||||||
* To free the entire #GStringChunk use g_string_chunk_free(). It is
|
* To free the entire `GStringChunk` use [method@GLib.Stringchunk.free].
|
||||||
* not possible to free individual strings.
|
* It is not possible to free individual strings.
|
||||||
*/
|
*/
|
||||||
|
|
||||||
/**
|
|
||||||
* GStringChunk:
|
|
||||||
*
|
|
||||||
* An opaque data structure representing String Chunks.
|
|
||||||
* It should only be accessed by using the following functions.
|
|
||||||
*/
|
|
||||||
struct _GStringChunk
|
struct _GStringChunk
|
||||||
{
|
{
|
||||||
GHashTable *const_table;
|
GHashTable *const_table;
|
||||||
|
Loading…
x
Reference in New Issue
Block a user