| Cutter Reference Manual | ||||
|---|---|---|---|---|
| Top | Description | ||||
Assertion Utilities for GListAssertion Utilities for GList — Utilities to write assertions related to GList more easily. |
#define gcut_list_enum_inspect (list, type) gboolean gcut_list_equal (const GList *list1,const GList *list2,GEqualFunc equal_func); gboolean gcut_list_equal_int (const GList *list1,const GList *list2); gboolean gcut_list_equal_string (const GList *list1,const GList *list2); gboolean gcut_list_equal_uint (const GList *list1,const GList *list2); #define gcut_list_flags_inspect (list, type) gchar * gcut_list_inspect (const GList *list,GCutInspectFunction inspect_func,gpointer user_data); gchar * gcut_list_inspect_enum (GType type,const GList *list); gchar * gcut_list_inspect_flags (GType type,const GList *list); gchar * gcut_list_inspect_int (const GList *list); gchar * gcut_list_inspect_object (const GList *list); gchar * gcut_list_inspect_string (const GList *list); gchar * gcut_list_inspect_uint (const GList *list); #define gcut_list_int_equal (list1, list2) #define gcut_list_int_inspect (list) #define gcut_list_object_inspect (list) #define gcut_list_string_equal (list1, list2) #define gcut_list_string_inspect (list) #define gcut_list_uint_equal (list1, list2) #define gcut_list_uint_inspect (list)
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.
#define gcut_list_enum_inspect(list, type)
gcut_list_enum_inspect has been deprecated since version 1.0.6 and should not be used in newly-written code. Use gcut_list_inspect_enum() instead.
Inspects list. list should be GList of enum value of
GEnum. The returned string should be freed when no
longer needed.
|
a GList of enum value to be inspected. |
|
a GEnum type. |
Returns : |
inspected list as a string. |
Since 1.0.5
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.:
1 |
TODO |
|
a GList to be compared. |
|
a GList to be compared. |
|
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
gboolean gcut_list_equal_int (const GList *list1,const GList *list2);
Compares two GList, list1 and list2. list1 and list2
should be GList of gint.
|
a GList of gint to be compared. |
|
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.6
gboolean gcut_list_equal_string (const GList *list1,const GList *list2);
Compares two GList, list1 and list2. list1 and list2
should be GList of string.
|
a GList of string to be compared. |
|
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.6
gboolean gcut_list_equal_uint (const GList *list1,const GList *list2);
Compares two GList, list1 and list2. list1 and list2
should be GList of guint.
|
a GList of guint to be compared. |
|
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.6
#define gcut_list_flags_inspect(list, type)
gcut_list_flags_inspect has been deprecated since version 1.0.6 and should not be used in newly-written code. Use gcut_list_inspect_flags() instead.
Inspects list. list should be GList of flags value of
GFlags. The returned string should be freed when no
longer needed.
|
a GList of flags value to be inspected. |
|
a GFlags type. |
Returns : |
inspected list as a string. |
Since 1.0.5
gchar * gcut_list_inspect (const GList *list,GCutInspectFunction 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.:
1 |
TODO |
|
a GList to be inspected. |
|
a function that inspects each value. |
|
user data to pass to the function. |
Returns : |
inspected list as a string. |
Since 1.0.5
gchar * gcut_list_inspect_enum (GType type,const GList *list);
Inspects list. list should be GList of enum value of
GEnum. The returned string should be freed when no
longer needed.
|
a GEnum type. |
|
a GList of enum value to be inspected. |
Returns : |
inspected list as a string. |
Since 1.0.6
gchar * gcut_list_inspect_flags (GType type,const GList *list);
Inspects list. list should be GList of flags value of
GFlags. The returned string should be freed when no
longer needed.
|
a GFlags type. |
|
a GList of flags value to be inspected. |
Returns : |
inspected list as a string. |
Since 1.0.6
gchar * gcut_list_inspect_int (const GList *list);
Inspects list. list should be GList of gint. The
returned string should be freed when no longer needed.
Since 1.0.6
gchar * gcut_list_inspect_object (const GList *list);
Inspects list. list should be GList of GObject. The
returned string should be freed when no longer needed.
Since 1.0.6
gchar * gcut_list_inspect_string (const GList *list);
Inspects list. list should be GList of string. The
returned string should be freed when no longer needed.
|
a GList of string to be inspected. |
Returns : |
inspected list as a string. |
Since 1.0.6
gchar * gcut_list_inspect_uint (const GList *list);
Inspects list. list should be GList of guint. The
returned string should be freed when no longer needed.
Since 1.0.6
#define gcut_list_int_equal(list1, list2)
gcut_list_int_equal has been deprecated since version 1.0.6 and should not be used in newly-written code. Use gcut_list_equal_int() instead.
Compares two GList, list1 and list2. list1 and list2
should be GList of gint.
|
a GList of gint to be compared. |
|
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
#define gcut_list_int_inspect(list)
gcut_list_int_inspect has been deprecated since version 1.0.6 and should not be used in newly-written code. Use gcut_list_inspect_int() instead.
Inspects list. list should be GList of gint. The
returned string should be freed when no longer needed.
Since 1.0.5
#define gcut_list_object_inspect(list)
gcut_list_object_inspect has been deprecated since version 1.0.6 and should not be used in newly-written code. Use gcut_list_inspect_object() instead.
Inspects list. list should be GList of GObject. The
returned string should be freed when no longer needed.
Since 1.0.5
#define gcut_list_string_equal(list1, list2)
gcut_list_string_equal has been deprecated since version 1.0.6 and should not be used in newly-written code. Use gcut_list_equal_string() instead.
Compares two GList, list1 and list2. list1 and list2
should be GList of string.
|
a GList of string to be compared. |
|
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
#define gcut_list_string_inspect(list)
gcut_list_string_inspect has been deprecated since version 1.0.6 and should not be used in newly-written code. Use gcut_list_inspect_string() instead.
Inspects list. list should be GList of string. The
returned string should be freed when no longer needed.
|
a GList of string to be inspected. |
Returns : |
inspected list as a string. |
Since 1.0.5
#define gcut_list_uint_equal(list1, list2)
gcut_list_uint_equal has been deprecated since version 1.0.6 and should not be used in newly-written code. Use gcut_list_equal_uint() instead.
Compares two GList, list1 and list2. list1 and list2
should be GList of guint.
|
a GList of guint to be compared. |
|
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
#define gcut_list_uint_inspect(list)
gcut_list_uint_inspect has been deprecated since version 1.0.6 and should not be used in newly-written code. Use gcut_list_inspect_uint() instead.
Inspects list. list should be GList of guint. The
returned string should be freed when no longer needed.
Since 1.0.5