Gobject
[GLib]

Files
file	gnc-gobject-utils.h
	Gobject helper routines.

---

Function Documentation

void gnc_gobject_tracking_dump

(

void

)

Dump the entire object tracking database via the g_log() family of functions. This function is only called when gnucash exits, and at that point all of the objects should have been removed from the database and freed. Any object remaining is the result of a memory/object leakage.

Definition at line 105 of file gnc-gobject-utils.c.

{
    GHashTable *table;

    //printf("Enter %s:\n", G_STRFUNC);
    table = gnc_gobject_tracking_table();

    if (g_hash_table_size(table) > 0)
    {
        g_message("The following objects remain alive:");
        g_hash_table_foreach_remove(table, (GHRFunc)gnc_gobject_dump_list, NULL);
    }
    //printf("Leave %s:\n", G_STRFUNC);
}

void gnc_gobject_tracking_forget

(

GObject *

object

)

Tell gnucash to drop this object from the database.

Parameters:

object

The object to be dropped.

Tell gnucash to remember this object in the database.

Definition at line 204 of file gnc-gobject-utils.c.

{
    if (gnc_gobject_tracking_forget_internal(object))
        g_object_weak_unref(object, gnc_gobject_weak_cb, NULL);
}

const GList* gnc_gobject_tracking_get_list

(

const gchar *

name

)

Get a list of all known objects of a specified type.

Parameters:

name

The type name of the objects to be found. This is the name used when the object type was initialized. If unknown, it can be found by calling G_OBJECT_TYPE_NAME(object).

Returns:

A GList of objects of the specified type. This list is owned by the tracking code and must not be modified by the caller.

Get a list of all known objects of a specified type.

Definition at line 230 of file gnc-gobject-utils.c.

{
    GHashTable *table;
    GList *list;

    //printf("Enter %s: name %s\n", G_STRFUNC, name);
    table = gnc_gobject_tracking_table();
    list = g_hash_table_lookup(table, name);
    //printf("Leave %s: list %p\n", G_STRFUNC, list);
    return list;
}

void gnc_gobject_tracking_remember	(	GObject *	object,
		GObjectClass *	klass
	)

Tell gnucash to remember this object in the database.

Parameters:

	object	The object to be tracked. This can be a fully or partially instantiated object.
	klass	The class structure for the object. This argument may be NULL if a fully instantiated object is passed in as the first argument. If a partially instantiated object is provided (I.E. a parent class called this function) then this argument is required. This is necessary because the class of the object changes as each of the parent class is instantiated. The class structure, however, status constant and always reflects the fully instantiated object.

Tell gnucash to remember this object in the database.

Definition at line 124 of file gnc-gobject-utils.c.

{
    GHashTable *table;
    GList *list;
    const gchar *name;

    g_return_if_fail(G_IS_OBJECT(object));

    /* Little dance here to handle startup conditions. During object
     * initialization the object type changes as each each parent class
     * is initialized.  The class passed to the initialization function
     * is always the ultimate class of the object. */
    if (klass == NULL)
        klass = G_OBJECT_GET_CLASS(object);
    name = g_type_name(G_TYPE_FROM_CLASS(klass));

    //printf("Enter %s: object %p of type %s\n", G_STRFUNC, object, name);
    table = gnc_gobject_tracking_table();
    list = g_hash_table_lookup(table, name);

    if (g_list_index(list, object) != -1)
    {
        g_critical("Object %p is already in list of %s", object, name);
        //printf("Leave %s: already in list\n", G_STRFUNC);
        return;
    }

    list = g_list_append(list, object);
    g_hash_table_insert(table, g_strdup(name), list);

    g_object_weak_ref(object, gnc_gobject_weak_cb, NULL);
    //printf("Leave %s:\n", G_STRFUNC);
}