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

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

Browse Source 
g_boxed_type_register_static, G_DEFINE_BOXED_TYPE: added correlating information

See merge request GNOME/glib!2188
This commit is contained in:
Philip Withnall 2021-07-22 12:16:41 +00:00
commit 38ccaf79c8
2 changed files with 22 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
gobject/gboxed.c
View File

@ -283,6 +283,10 @@ boxed_proxy_lcopy_value (const GValue *value,
* boxed type with name @name. Boxed type handling functions have to be * boxed type with name @name. Boxed type handling functions have to be
* provided to copy and free opaque boxed structures of this type. * provided to copy and free opaque boxed structures of this type.
* *
* For the general case, it is recommended to use #G_DEFINE_BOXED_TYPE
* instead of calling g_boxed_type_register_static() directly. The macro
* will create the appropriate `*_get_type()` function for the boxed type.
*
* Returns: New %G_TYPE_BOXED derived type id for @name. * Returns: New %G_TYPE_BOXED derived type id for @name.
*/ */
GType GType

20
gobject/gtype.h
View File

@ -2071,8 +2071,24 @@ type_name##_get_type (void) \
* @copy_func: the #GBoxedCopyFunc for the new type * @copy_func: the #GBoxedCopyFunc for the new type
* @free_func: the #GBoxedFreeFunc for the new type * @free_func: the #GBoxedFreeFunc for the new type
* *
* A convenience macro for boxed type implementations, which defines a * A convenience macro for defining a new custom boxed type.
* type_name_get_type() function registering the boxed type. *
* Using this macro is the recommended way of defining new custom boxed
* types, over calling g_boxed_type_register_static() directly. It defines
* a `type_name_get_type()` function which will return the newly defined
* #GType, enabling lazy instantiation.
*
* |[<!-- language="C" -->
* G_DEFINE_BOXED_TYPE (MyStruct, my_struct, my_struct_copy, my_struct_free)
*
* void
* foo ()
* {
* GType type = my_struct_get_type ();
* // ... your code ...
* }
*
* ]|
* *
* Since: 2.26 * Since: 2.26
*/ */