luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2025-09-27 17:52:58 +02:00
Code Issues Packages Projects Releases Wiki Activity

introspection: use (nullable) or (optional) instead of (allow-none)

Browse Source 
If we have an input parameter (or return value) we need to use (nullable).
However, if it is an (inout) or (out) parameter, (optional) is sufficient.

It looks like (nullable) could be used for everything according to the
Annotation documentation, but (optional) is more specific.
This commit is contained in:
Christian Hergert
2016-10-28 18:29:02 -07:00
parent a4012abbdf
commit 18a33f72db
151 changed files with 986 additions and 987 deletions
Download Patch File Download Diff File Expand all files Collapse all files

10
gobject/gvaluetypes.c
View File

@@ -1023,7 +1023,7 @@ g_value_get_double (const GValue *value)
/**
* g_value_set_string:
* @value: a valid #GValue of type %G_TYPE_STRING
* @v_string: (allow-none): caller-owned string to be duplicated for the #GValue
* @v_string: (nullable): caller-owned string to be duplicated for the #GValue
*
* Set the contents of a %G_TYPE_STRING #GValue to @v_string.
*/
@@ -1048,7 +1048,7 @@ g_value_set_string (GValue *value,
/**
* g_value_set_static_string:
* @value: a valid #GValue of type %G_TYPE_STRING
* @v_string: (allow-none): static string to be set
* @v_string: (nullable): static string to be set
*
* Set the contents of a %G_TYPE_STRING #GValue to @v_string.
* The string is assumed to be static, and is thus not duplicated
@@ -1069,7 +1069,7 @@ g_value_set_static_string (GValue *value,
/**
* g_value_set_string_take_ownership:
* @value: a valid #GValue of type %G_TYPE_STRING
* @v_string: (allow-none): duplicated unowned string to be set
* @v_string: (nullable): duplicated unowned string to be set
*
* This is an internal function introduced mainly for C marshallers.
*
@@ -1085,7 +1085,7 @@ g_value_set_string_take_ownership (GValue *value,
/**
* g_value_take_string:
* @value: a valid #GValue of type %G_TYPE_STRING
* @v_string: (allow-none): string to take ownership of
* @v_string: (nullable): string to take ownership of
*
* Sets the contents of a %G_TYPE_STRING #GValue to @v_string.
*
@@ -1210,7 +1210,7 @@ g_value_get_gtype (const GValue *value)
/**
* g_value_set_variant:
* @value: a valid #GValue of type %G_TYPE_VARIANT
* @variant: (allow-none): a #GVariant, or %NULL
* @variant: (nullable): a #GVariant, or %NULL
*
* Set the contents of a variant #GValue to @variant.
* If the variant is floating, it is consumed.