luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2025-02-26 20:22:11 +01:00
Code Issues Packages Projects Releases Wiki Activity

Merge branch 'DarkTrick-main-patch-15325' into 'main'

Browse Source 
Update GValue doc: How to use GBoxed with GValue

See merge request GNOME/glib!2179
This commit is contained in:
Philip Withnall 2021-07-22 12:37:43 +00:00
commit 950bbe7984
1 changed files with 25 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

24
gobject/gvalue.c
View File

@ -117,6 +117,30 @@
* See also [gobject-Standard-Parameter-and-Value-Types] for more information on * See also [gobject-Standard-Parameter-and-Value-Types] for more information on
* validation of #GValue. * validation of #GValue.
* *
* For letting a #GValue own (and memory manage) arbitrary types or pointers,
* they need to become a [boxed type][gboxed]. The example below shows how
* the pointer `mystruct` of type `MyStruct` is used as a [boxed type][gboxed].
*
* |[<!-- language="C" -->
* typedef struct { ... } MyStruct;
* G_DEFINE_BOXED_TYPE (MyStruct, my_struct, my_struct_copy, my_struct_free)
*
* // These two lines normally go in a public header. By GObject convention,
* // the naming scheme is NAMESPACE_TYPE_NAME:
* #define MY_TYPE_STRUCT (my_struct_get_type ())
* GType my_struct_get_type (void);
*
* void
* foo ()
* {
* GValue *value = g_new0 (GValue, 1);
* g_value_init (value, MY_TYPE_STRUCT);
* g_value_set_boxed (value, mystruct);
* // [... your code ....]
* g_value_unset (value);
* g_value_free (value);
* }
* ]|
*/ */