luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2024-11-09 02:46:16 +01:00
Code Issues Packages Projects Releases Wiki Activity

Merge branch 'update-variant-child-value-docs' into 'master'

Browse Source 
gvariant-core: Add a note about memory safety of children

See merge request GNOME/glib!1462
This commit is contained in:
Philip Withnall 2020-04-28 11:13:43 +00:00
commit c9bf247eb9
1 changed files with 6 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
glib/gvariant-core.c
View File

@ -1026,6 +1026,12 @@ g_variant_n_children (GVariant *value)
* The returned value is never floating. You should free it with * The returned value is never floating. You should free it with
* g_variant_unref() when you're done with it. * g_variant_unref() when you're done with it.
* *
* Note that values borrowed from the returned child are not guaranteed to
* still be valid after the child is freed even if you still hold a reference
* to @value, if @value has not been serialised at the time this function is
* called. To avoid this, you can serialize @value by calling
* g_variant_get_data() and optionally ignoring the return value.
*
* There may be implementation specific restrictions on deeply nested values, * There may be implementation specific restrictions on deeply nested values,
* which would result in the unit tuple being returned as the child value, * which would result in the unit tuple being returned as the child value,
* instead of further nested children. #GVariant is guaranteed to handle * instead of further nested children. #GVariant is guaranteed to handle