Document G_VALUE_NOCOPY_CONTENTS

https://bugzilla.gnome.org/show_bug.cgi?id=624943
This commit is contained in:
Matthias Clasen 2011-02-18 22:42:24 -05:00
parent 2a1eed20b4
commit 9dd1f75a41
2 changed files with 10 additions and 2 deletions

View File

@ -1186,7 +1186,7 @@ struct _GInterfaceInfo
* return g_strdup_printf ("object location passed as NULL");
* if (!value->data[0].v_pointer)
* *object_p = NULL;
* else if (collect_flags & G_VALUE_NOCOPY_CONTENTS) // always honour
* else if (collect_flags & G_VALUE_NOCOPY_CONTENTS) /* always honour */
* *object_p = value->data[0].v_pointer;
* else
* *object_p = g_object_ref (value->data[0].v_pointer);

View File

@ -151,7 +151,15 @@ gboolean g_value_transform (const GValue *src_value,
void g_value_register_transform_func (GType src_type,
GType dest_type,
GValueTransform transform_func);
#define G_VALUE_NOCOPY_CONTENTS (1 << 27)
/**
* G_VALUE_NOCOPY_CONTENTS:
*
* If passed to G_VALUE_COLLECT(), allocated data won't be copied
* but used verbatim. This does not affect ref-counted types like
* objects. For more details, see the #GValueTable documentation.
*/
#define G_VALUE_NOCOPY_CONTENTS (1 << 27)
G_END_DECLS