| Cutter Reference Manual | ||||
|---|---|---|---|---|
| Top | Description | ||||
Assertions with GLib supportAssertions with GLib support — Checks that your program works as you expect with GLib support. |
void gcut_assert_equal_type (GType expected,GType actual,...); void cut_assert_equal_g_type (GType expected,GType actual,...); void gcut_assert_equal_value (GValue *expected,GValue *actual,...); void cut_assert_equal_g_value (GValue *expected,GValue *actual,...); void gcut_assert_equal_list (GList *expected,GList *actual,GEqualFunc equal_function,GCutInspectFunction inspect_function,gpointer inspect_user_data,...); void gcut_assert_equal_list_int (GList *expected,GList *actual,...); void cut_assert_equal_g_list_int (GList *expected,GList *actual,...); void gcut_assert_equal_list_uint (GList *expected,GList *actual,...); void gcut_assert_equal_list_string (GList *expected,GList *actual,...); void cut_assert_equal_g_list_string (GList *expected,GList *actual,...); void gcut_assert_equal_list_object (GList *expected,GList *actual,...); void gcut_assert_equal_list_object_custom (GList *expected,GList *actual,GEqualFunc equal_function,...); void gcut_assert_equal_list_enum (GType type,GList *expected,GList *actual,...); void gcut_assert_equal_list_flags (GType type,GList *expected,GList *actual,...); void gcut_assert_equal_hash_table (GHashTable *expected,GHashTable *actual,GEqualFunc equal_function,GCutInspectFunction key_inspect_function,GCutInspectFunction value_inspect_function,gpointer inspect_user_data,...); void gcut_assert_equal_hash_table_string_string (GHashTable *expected,GHashTable *actual,...); void gcut_assert_error (GError *error,...); void cut_assert_g_error (GError *error,...); void gcut_assert_equal_error (GError *expected,GError *actual,...); void gcut_assert_remove_path (const gchar *path,...); void cut_assert_remove_path (const gchar *path,...); void gcut_assert_equal_time_val (GTimeVal expected,GTimeVal actual,...); void gcut_assert_equal_enum (GType enum_type,gint expected,gint actual,...); void gcut_assert_equal_flags (GType flags_type,guint expected,guint actual,...); void gcut_assert_equal_object (GObject *expected,GObject *actual,...); void gcut_assert_equal_object_custom (GObject *expected,GObject *actual,GEqualFunc equal_function,...); void gcut_assert_equal_int64 (gint64 expected,gint64 actual,...); void gcut_assert_not_equal_int64 (gint64 expected,gint64 actual,...); void gcut_assert_equal_uint64 (guint64 expected,guint64 actual,...); void gcut_assert_not_equal_uint64 (guint64 expected,guint64 actual,...); void gcut_assert_equal_pid (GPid expected,GPid actual,...); void gcut_assert_not_equal_pid (GPid expected,GPid actual,...); void gcut_assert_equal_string (GString *expected,GString *actual,...);
void gcut_assert_equal_type (GType expected,GType actual,...);
Passes if expected == actual.
|
an expected value. |
|
an actual value. |
|
optional message. See cut_message() for details.
|
Since 1.0.3
void cut_assert_equal_g_type (GType expected,GType actual,...);
cut_assert_equal_g_type has been deprecated since version 1.0.3 and should not be used in newly-written code. Use gcut_assert_equal_type() instead.
Passes if expected == actual.
|
an expected value. |
|
an actual value. |
|
optional message. See cut_message() for details.
|
void gcut_assert_equal_value (GValue *expected,GValue *actual,...);
Passes if expected == actual.
|
an expected value. |
|
an actual value. |
|
optional message. See cut_message() for details.
|
Since 1.0.3
void cut_assert_equal_g_value (GValue *expected,GValue *actual,...);
cut_assert_equal_g_value has been deprecated since version 1.0.3 and should not be used in newly-written code. Use gcut_assert_equal_value() instead.
Passes if expected == actual.
|
an expected value. |
|
an actual value. |
|
optional message. See cut_message() for details.
|
void gcut_assert_equal_list (GList *expected,GList *actual,GEqualFunc equal_function,GCutInspectFunction inspect_function,gpointer inspect_user_data,...);
Passes if equal_function(expected, actual) == CUT_TRUE.
|
an expected list. |
|
an actual list. |
|
a function that compares each elements of
expected and actual list.
|
|
a function that inspected expected
and actual list.
|
|
a data to be passed to inspect_function.
|
|
optional message. See cut_message() for details.
|
Since 1.0.6
void gcut_assert_equal_list_int (GList *expected,GList *actual,...);
Passes if expected == actual.
|
an expected list of integer. |
|
an actual list of integer. |
|
optional message. See cut_message() for details.
|
Since 1.0.3
void cut_assert_equal_g_list_int (GList *expected,GList *actual,...);
cut_assert_equal_g_list_int has been deprecated since version 1.0.3 and should not be used in newly-written code. Use gcut_assert_equal_list_int() instead.
Passes if expected == actual.
|
an expected list of integer. |
|
an actual list of integer. |
|
optional message. See cut_message() for details.
|
Since 0.8
void gcut_assert_equal_list_uint (GList *expected,GList *actual,...);
Passes if expected == actual.
|
an expected list of unsigned integer. |
|
an actual list of unsigned integer. |
|
optional message. See cut_message() for details.
|
Since 1.0.3
void gcut_assert_equal_list_string (GList *expected,GList *actual,...);
Passes if expected == actual.
|
an expected list of string. |
|
an actual list of string. |
|
optional message. See cut_message() for details.
|
Since 1.0.3
void cut_assert_equal_g_list_string (GList *expected,GList *actual,...);
cut_assert_equal_g_list_string has been deprecated since version 1.0.3 and should not be used in newly-written code. Use gcut_assert_equal_list_string() instead.
Passes if expected == actual.
|
an expected list of string. |
|
an actual list of string. |
|
optional message. See cut_message() for details.
|
Since 0.8
void gcut_assert_equal_list_object (GList *expected,GList *actual,...);
Passes if expected and actual has same GObject * in
same order.
|
an expected list of GObject. |
|
an actual list of GObject. |
|
optional message. See cut_message() for details.
|
Since 1.0.5
void gcut_assert_equal_list_object_custom (GList *expected,GList *actual,GEqualFunc equal_function,...);
Passes if expected and actual has same GObject in same
order. Each comparison of GObject uses equal_function.
|
an expected list of GObject. |
|
an actual list of GObject. |
|
a function that compares two GObject. |
|
optional message. See cut_message() for details.
|
Since 1.0.5
void gcut_assert_equal_list_enum (GType type,GList *expected,GList *actual,...);
Passes if expected and actual has same enum values in
same order.
|
a GEnum type. |
|
an expected list of enum value. |
|
an actual list of enum value. |
|
optional message. See cut_message() for details.
|
Since 1.0.5
void gcut_assert_equal_list_flags (GType type,GList *expected,GList *actual,...);
Passes if expected and actual has same flags values in
same order.
|
a GFlags type. |
|
an expected list of flags value. |
|
an actual list of flags value. |
|
optional message. See cut_message() for details.
|
Since 1.0.5
void gcut_assert_equal_hash_table (GHashTable *expected,GHashTable *actual,GEqualFunc equal_function,GCutInspectFunction key_inspect_function,GCutInspectFunction value_inspect_function,gpointer inspect_user_data,...);
Passes if expected == actual.
|
an expected GHashTable of string. |
|
an actual GHashTable of string. |
|
a function that compares each values of
expected and actual hash table.
|
|
a function that inspected a key of
expected and actual hash table.
|
|
a function that inspected a value of
expected and actual hash table.
|
|
a data to be passed to inspect_function.
|
|
optional message. See cut_message() for details.
|
Since 1.0.6
void gcut_assert_equal_hash_table_string_string (GHashTable *expected,GHashTable *actual,...);
Passes if expected == actual.
|
an expected GHashTable of string. |
|
an actual GHashTable of string. |
|
optional message. See cut_message() for details.
|
Since 1.0.4
void gcut_assert_error (GError *error,...);
Passes if error == NULL.
|
a target GError. |
|
optional message. See cut_message() for details.
|
Since 1.0.3
void cut_assert_g_error (GError *error,...);
cut_assert_g_error has been deprecated since version 1.0.3 and should not be used in newly-written code. Use gcut_assert_error() instead.
Passes if error == NULL.
|
a target GError. |
|
optional message. See cut_message() for details.
|
Since 1.0
void gcut_assert_equal_error (GError *expected,GError *actual,...);
Passes if expected == actual.
|
an expected value. |
|
an actual value. |
|
optional message. See cut_message() for details.
|
Since 1.0.5
void gcut_assert_remove_path (const gchar *path,...);
Passes if cut_utils_build_path(path, ...) is removed successfully.
|
a first element of the path to the removed path. |
|
remaining elements in path. NULL terminated. |
Since 1.0.3
void cut_assert_remove_path (const gchar *path,...);
cut_assert_remove_path has been deprecated since version 1.0.3 and should not be used in newly-written code. Use gcut_assert_remove_path() instead.
Passes if cut_utils_build_path(path, ...) is removed successfully.
|
a first element of the path to the removed path. |
|
remaining elements in path. NULL terminated. |
Since 1.0.2
void gcut_assert_equal_time_val (GTimeVal expected,GTimeVal actual,...);
Passes if expected == actual.
|
an expected value. |
|
an actual value. |
|
optional message. See cut_message() for details.
|
Since 1.0.4
void gcut_assert_equal_enum (GType enum_type,gint expected,gint actual,...);
Passes if expected == actual.
e.g.:
1 2 3 4 |
gcut_assert_equal_enum(GTK_TYPE_DIRECTION_TYPE, GTK_DIR_LEFT, GTK_DIR_LEFT); -> Pass gcut_assert_equal_enum(GTK_TYPE_DIRECTION_TYPE, GTK_DIR_DOWN, GTK_DIR_LEFT); -> Fail |
|
a GEnum type. |
|
an expected value. |
|
an actual value. |
|
optional message. See cut_message() for details.
|
Since 1.0.5
void gcut_assert_equal_flags (GType flags_type,guint expected,guint actual,...);
Passes if expected == actual.
e.g.:
1 2 3 4 5 6 7 8 9 |
gcut_assert_equal_flags(GTK_TYPE_DIALOG_FLAGS, GTK_DIALOG_DESTROY_MODAL | GTK_DIALOG_DESTROY_WITH_PARENT, GTK_DIALOG_DESTROY_MODAL | GTK_DIALOG_DESTROY_WITH_PARENT); -> Pass gcut_assert_equal_flags(GTK_TYPE_DIALOG_FLAGS, GTK_DIALOG_DESTROY_MODAL | GTK_DIALOG_DESTROY_WITH_PARENT, GTK_DIALOG_DESTROY_MODAL); -> Fail |
|
a GFlags type. |
|
an expected value. |
|
an actual value. |
|
optional message. See cut_message() for details.
|
Since 1.0.5
void gcut_assert_equal_object (GObject *expected,GObject *actual,...);
Passes if expected == actual. See
gcut_assert_equal_object_custom() when you need to customize
equality check.
e.g.:
1 2 3 4 |
gcut_assert_equal_object(object, object); -> Pass gcut_assert_equal_object(object1, object2); -> Fail gcut_assert_equal_object(NULL, NULL); -> Pass gcut_assert_equal_object(object1, NULL); -> Fail |
|
an expected value. |
|
an actual value. |
|
optional message. See cut_message() for details.
|
Since 1.0.5
void gcut_assert_equal_object_custom (GObject *expected,GObject *actual,GEqualFunc equal_function,...);
Passes if equal_function(expected, actual) == CUT_TRUE.
e.g.:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 |
static gboolean equal_name (gconstpointer data1, gconstpointer data2) { return g_str_equal(my_object_get_name(MY_OBJECT(data1)), my_object_get_name(MY_OBJECT(data2))); } gcut_assert_equal_object_custom(object, object, equal_name); -> Pass gcut_assert_equal_object_custom(same_name_object1, same_name_object2, equal_name); -> Pass gcut_assert_equal_object_custom(different_name_object1, different_name_object2, equal_name); -> Fail |
|
an expected value. |
|
an actual value. |
|
a function that compare two objects. |
|
optional message. See cut_message() for details.
|
Since 1.0.5
void gcut_assert_equal_int64 (gint64 expected,gint64 actual,...);
Passes if expected == actual.
|
an expected value. |
|
an actual value. |
|
optional message. See cut_message() for details.
|
Since 1.0.5
void gcut_assert_not_equal_int64 (gint64 expected,gint64 actual,...);
Passes if expected != actual.
|
an expected value. |
|
an actual value. |
|
optional message. See cut_message() for details.
|
Since 1.1.4
void gcut_assert_equal_uint64 (guint64 expected,guint64 actual,...);
Passes if expected == actual.
|
an expected value. |
|
an actual value. |
|
optional message. See cut_message() for details.
|
Since 1.0.5
void gcut_assert_not_equal_uint64 (guint64 expected,guint64 actual,...);
Passes if expected != actual.
|
an expected value. |
|
an actual value. |
|
optional message. See cut_message() for details.
|
Since 1.1.4
void gcut_assert_equal_pid (GPid expected,GPid actual,...);
Passes if expected == actual.
|
an expected value. |
|
an actual value. |
|
optional message. See cut_message() for details.
|
Since 1.0.6
void gcut_assert_not_equal_pid (GPid expected,GPid actual,...);
Passes if expected != actual.
|
an expected value. |
|
an actual value. |
|
optional message. See cut_message() for details.
|
Since 1.0.7
void gcut_assert_equal_string (GString *expected,GString *actual,...);
Passes if expected == actual.
|
an expected value. |
|
an actual value. |
|
optional message. See cut_message() for details.
|
Since 1.1.5