Assertion Utilities for GObject

Assertion Utilities for GObject — Utilities to write assertions related to GObject more easily.

Synopsis

gboolean            gcut_object_equal                   (const GObject *object1,
                                                         const GObject *object2,
                                                         GEqualFunc equal_func);
gchar *             gcut_object_inspect                 (const GObject *object);
gchar *             gcut_object_inspect_custom          (const GObject *object,
                                                         GCutInspectFunction inspect_func,
                                                         gpointer user_data);

Description

To write assertions, you need to check equality and show expected and actual values.

The utilities help you to write assertions that are related to GObject.

Details

gcut_object_equal ()

gboolean            gcut_object_equal                   (const GObject *object1,
                                                         const GObject *object2,
                                                         GEqualFunc equal_func);

Compares two GObject, object1 and object2 by equal_func. If equal_func is NULL, object1 and object2 is just only compared by memory location.

object1 :

a GObject to be compared.

object2 :

a GObject to be compared.

equal_func :

a function that compares two GObject. NULL is OK.

Returns :

TRUE if object1 == object2 or equal_func(object1, object2), FALSE otherwise.

Since 1.0.5


gcut_object_inspect ()

gchar *             gcut_object_inspect                 (const GObject *object);

Inspects object's property. The returned string should be freed when no longer needed.

object :

a GObject.

Returns :

inspected object as a string.

Since 1.0.5


gcut_object_inspect_custom ()

gchar *             gcut_object_inspect_custom          (const GObject *object,
                                                         GCutInspectFunction inspect_func,
                                                         gpointer user_data);

Inspects object by inspect_func. The returned string should be freed when no longer needed.

object :

a GObject.

inspect_func :

a function that inspects object.

user_data :

user data to pass to the function.

Returns :

inspected object as a string.

Since 1.0.5