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

Improve the documentation for G_DEFINE_TYPE_WITH_PRIVATE

Browse Source 
Connect the dots between G_ADD_PRIVATE and the various G_DEFINE_* macros
that use it, as well as expanding the code example for
G_DEFINE_TYPE_EXTENDED with a private instance data declaration.

Closes: #943
This commit is contained in:
Emmanuele Bassi 2019-07-14 17:50:35 +01:00
parent d56bdeb926
commit 87016536a6
1 changed files with 20 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

23
gobject/gtype.h
View File

@ -1630,6 +1630,11 @@ guint g_type_get_type_registration_serial (void);
* Note that private structs added with this macros must have a struct
* name of the form @TN Private.
*
* The private instance data can be retrieved using the automatically generated
* getter function `t_n_get_instance_private()`.
*
* See also: G_ADD_PRIVATE()
*
* Since: 2.38
*/
#define G_DEFINE_TYPE_WITH_PRIVATE(TN, t_n, T_P) G_DEFINE_TYPE_EXTENDED (TN, t_n, T_P, 0, G_ADD_PRIVATE (TN))
@ -1694,6 +1699,7 @@ guint g_type_get_type_registration_serial (void);
* gtk_gadget,
* GTK_TYPE_WIDGET,
* 0,
* G_ADD_PRIVATE (GtkGadget)
* G_IMPLEMENT_INTERFACE (TYPE_GIZMO,
* gtk_gadget_gizmo_init));
* ]|
@ -1702,11 +1708,18 @@ guint g_type_get_type_registration_serial (void);
* static void gtk_gadget_init (GtkGadget *self);
* static void gtk_gadget_class_init (GtkGadgetClass *klass);
* static gpointer gtk_gadget_parent_class = NULL;
* static gint GtkGadget_private_offset;
* static void gtk_gadget_class_intern_init (gpointer klass)
* {
* gtk_gadget_parent_class = g_type_class_peek_parent (klass);
* if (GtkGadget_private_offset != 0)
* g_type_class_adjust_private_offset (klass, &GtkGadget_private_offset);
* gtk_gadget_class_init ((GtkGadgetClass*) klass);
* }
* static inline gpointer gtk_gadget_get_instance_private (GtkGadget *self)
* {
* return (G_STRUCT_MEMBER_P (self, GtkGadget_private_offset));
* }
*
* GType
* gtk_gadget_get_type (void)
@ -1723,6 +1736,10 @@ guint g_type_get_type_registration_serial (void);
* (GInstanceInitFunc) gtk_gadget_init,
* 0);
* {
* GtkGadget_private_offset =
* g_type_add_instance_private (g_define_type_id, sizeof (GtkGadgetPrivate));
* }
* {
* const GInterfaceInfo g_implement_interface_info = {
* (GInterfaceInitFunc) gtk_gadget_gizmo_init
* };
@ -1866,9 +1883,9 @@ guint g_type_get_type_registration_serial (void);
* Also note that private structs added with these macros must have a struct
* name of the form `TypeNamePrivate`.
*
* It is safe to call _get_instance_private on %NULL or invalid object since
* it's only adding an offset to the instance pointer. In that case the returned
* pointer must not be dereferenced.
* It is safe to call the `_get_instance_private` function on %NULL or invalid
* objects since it's only adding an offset to the instance pointer. In that
* case the returned pointer must not be dereferenced.
*
* Since: 2.38
*/