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

Link to gvariant-format-strings-pointers in getter API

Browse Source 
https://bugzilla.gnome.org/show_bug.cgi?id=674777
This commit is contained in:
Guillaume Desmottes 2012-04-27 10:02:54 +02:00
parent 175864b83c
commit ae421c9f6c
1 changed files with 29 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

30
glib/gvariant.c
View File

@ -954,7 +954,10 @@ g_variant_new_dict_entry (GVariant *key,
* this function returns %FALSE. Otherwise, it unpacks the returned * this function returns %FALSE. Otherwise, it unpacks the returned
* value and returns %TRUE. * value and returns %TRUE.
* *
* See g_variant_get() for information about @format_string. * @format_string determines the C types that are used for unpacking
* the values and also determines if the values are copied or borrowed,
* see the section on
* <link linkend='gvariant-format-strings-pointers'>GVariant Format Strings</link>.
* *
* Returns: %TRUE if a value was unpacked * Returns: %TRUE if a value was unpacked
* *
@ -4614,6 +4617,11 @@ g_variant_new_va (const gchar *format_string,
* Please note that the syntax of the format string is very likely to be * Please note that the syntax of the format string is very likely to be
* extended in the future. * extended in the future.
* *
* @format_string determines the C types that are used for unpacking
* the values and also determines if the values are copied or borrowed,
* see the section on
* <link linkend='gvariant-format-strings-pointers'>GVariant Format Strings</link>.
*
* Since: 2.24 * Since: 2.24
**/ **/
void void
@ -4662,6 +4670,11 @@ g_variant_get (GVariant *value,
* g_variant_new_va() and g_variant_get_va() within a single actual * g_variant_new_va() and g_variant_get_va() within a single actual
* varargs call by the user. * varargs call by the user.
* *
* @format_string determines the C types that are used for unpacking
* the values and also determines if the values are copied or borrowed,
* see the section on
* <link linkend='gvariant-format-strings-pointers'>GVariant Format Strings</link>.
*
* Since: 2.24 * Since: 2.24
**/ **/
void void
@ -4748,6 +4761,11 @@ g_variant_builder_add (GVariantBuilder *builder,
* essentially a combination of g_variant_get_child_value() and * essentially a combination of g_variant_get_child_value() and
* g_variant_get(). * g_variant_get().
* *
* @format_string determines the C types that are used for unpacking
* the values and also determines if the values are copied or borrowed,
* see the section on
* <link linkend='gvariant-format-strings-pointers'>GVariant Format Strings</link>.
*
* Since: 2.24 * Since: 2.24
**/ **/
void void
@ -4816,6 +4834,11 @@ g_variant_get_child (GVariant *value,
* For a solution that is likely to be more convenient to C programmers * For a solution that is likely to be more convenient to C programmers
* when dealing with loops, see g_variant_iter_loop(). * when dealing with loops, see g_variant_iter_loop().
* *
* @format_string determines the C types that are used for unpacking
* the values and also determines if the values are copied or borrowed,
* see the section on
* <link linkend='gvariant-format-strings-pointers'>GVariant Format Strings</link>.
*
* Returns: %TRUE if a value was unpacked, or %FALSE if there as no value * Returns: %TRUE if a value was unpacked, or %FALSE if there as no value
* *
* Since: 2.24 * Since: 2.24
@ -4914,6 +4937,11 @@ g_variant_iter_next (GVariantIter *iter,
* types, use the '&' prefix to avoid allocating any memory at all (and * types, use the '&' prefix to avoid allocating any memory at all (and
* thereby avoiding the need to free anything as well). * thereby avoiding the need to free anything as well).
* *
* @format_string determines the C types that are used for unpacking
* the values and also determines if the values are copied or borrowed,
* see the section on
* <link linkend='gvariant-format-strings-pointers'>GVariant Format Strings</link>.
*
* Returns: %TRUE if a value was unpacked, or %FALSE if there was no * Returns: %TRUE if a value was unpacked, or %FALSE if there was no
* value * value
* *