Assertion Utilities for GList

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

Synopsis

gboolean            gcut_list_equal                     (const GList *list1,
                                                         const GList *list2,
                                                         GEqualFunc equal_func);
gchar*              gcut_list_inspect                   (const GList *list,
                                                         GCutInspectFunc inspect_func,
                                                         gpointer user_data);
gboolean            gcut_list_int_equal                 (const GList *list1,
                                                         const GList *list2);
gchar*              gcut_list_int_inspect               (const GList *list);
gboolean            gcut_list_uint_equal                (const GList *list1,
                                                         const GList *list2);
gchar*              gcut_list_uint_inspect              (const GList *list);
gboolean            gcut_list_string_equal              (const GList *list1,
                                                         const GList *list2);
gchar*              gcut_list_string_inspect            (const GList *list);
gchar*              gcut_list_object_inspect            (const GList *list);
gchar*              gcut_list_enum_inspect              (const GList *list,
                                                         GType type);
gchar*              gcut_list_flags_inspect             (const GList *list,
                                                         GType type);

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 GList.

Details

gcut_list_equal ()

gboolean            gcut_list_equal                     (const GList *list1,
                                                         const GList *list2,
                                                         GEqualFunc equal_func);

Compares two GList, list1 and list2. equal_func is called for each corresponding values of list1 and list2.

e.g.:

TODO

list1 :

a GList to be compared.

list2 :

a GList to be compared.

equal_func :

a function that compares two values.

Returns :

TRUE if all corresponding values of list1 and list2 are reported TRUE by equal_func, FALSE otherwise.

Since 1.0.5


gcut_list_inspect ()

gchar*              gcut_list_inspect                   (const GList *list,
                                                         GCutInspectFunc inspect_func,
                                                         gpointer user_data);

Inspects list. Each value of list is inspected by inspect_func. The returned string should be freed when no longer needed.

e.g.:

TODO

list :

a GList to be inspected.

inspect_func :

a function that inspects each value.

user_data :

user data to pass to the function.

Returns :

inspected list as a string.

Since 1.0.5


gcut_list_int_equal ()

gboolean            gcut_list_int_equal                 (const GList *list1,
                                                         const GList *list2);

Compares two GList, list1 and list2. list1 and list2 should be GList of gint.

list1 :

a GList of gint to be compared.

list2 :

a GList of gint to be compared.

Returns :

TRUE if all corresponding integers of list1 and list2 are same value, FALSE otherwise.

Since 1.0.5


gcut_list_int_inspect ()

gchar*              gcut_list_int_inspect               (const GList *list);

Inspects list. list should be GList of gint. The returned string should be freed when no longer needed.

list :

a GList of gint to be inspected.

Returns :

inspected list as a string.

Since 1.0.5


gcut_list_uint_equal ()

gboolean            gcut_list_uint_equal                (const GList *list1,
                                                         const GList *list2);

Compares two GList, list1 and list2. list1 and list2 should be GList of guint.

list1 :

a GList of guint to be compared.

list2 :

a GList of guint to be compared.

Returns :

TRUE if all corresponding unsigned integers of list1 and list2 are same value, FALSE otherwise.

Since 1.0.5


gcut_list_uint_inspect ()

gchar*              gcut_list_uint_inspect              (const GList *list);

Inspects list. list should be GList of guint. The returned string should be freed when no longer needed.

list :

a GList of guint to be inspected.

Returns :

inspected list as a string.

Since 1.0.5


gcut_list_string_equal ()

gboolean            gcut_list_string_equal              (const GList *list1,
                                                         const GList *list2);

Compares two GList, list1 and list2. list1 and list2 should be GList of string.

list1 :

a GList of string to be compared.

list2 :

a GList of string to be compared.

Returns :

TRUE if all corresponding string of list1 and list2 are same content string, FALSE otherwise.

Since 1.0.5


gcut_list_string_inspect ()

gchar*              gcut_list_string_inspect            (const GList *list);

Inspects list. list should be GList of string. The returned string should be freed when no longer needed.

list :

a GList of string to be inspected.

Returns :

inspected list as a string.

Since 1.0.5


gcut_list_object_inspect ()

gchar*              gcut_list_object_inspect            (const GList *list);

Inspects list. list should be GList of GObject. The returned string should be freed when no longer needed.

list :

a GList of GObject to be inspected.

Returns :

inspected list as a string.

Since 1.0.5


gcut_list_enum_inspect ()

gchar*              gcut_list_enum_inspect              (const GList *list,
                                                         GType type);

Inspects list. list should be GList of enum value of GEnum. The returned string should be freed when no longer needed.

list :

a GList of enum value to be inspected.

type :

a GEnum type.

Returns :

inspected list as a string.

Since 1.0.5


gcut_list_flags_inspect ()

gchar*              gcut_list_flags_inspect             (const GList *list,
                                                         GType type);

Inspects list. list should be GList of flags value of GFlags. The returned string should be freed when no longer needed.

list :

a GList of flags value to be inspected.

type :

a GFlags type.

Returns :

inspected list as a string.

Since 1.0.5