![]() |
![]() |
![]() |
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_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_type (GType expected, GType actual, ...);
Passes if expected
== actual
.
|
an expected value. |
|
an actual value. |
|
optional format string, followed by parameters to insert
into the format string. (as with printf() ) This is
deprecated since 0.1.6. Use cut_set_message() instead.
|
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 format string, followed by parameters to insert
into the format string. (as with printf() ) This is
deprecated since 0.1.6. Use cut_set_message() instead.
|
void gcut_assert_equal_value (GValue *expected, GValue *actual, ...);
Passes if expected
== actual
.
|
an expected value. |
|
an actual value. |
|
optional format string, followed by parameters to insert
into the format string. (as with printf() ) This is
deprecated since 0.1.6. Use cut_set_message() instead.
|
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 format string, followed by parameters to insert
into the format string. (as with printf() ) This is
deprecated since 0.1.6. Use cut_set_message() instead.
|
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 .
|
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 format string, followed by parameters to insert
into the format string. (as with printf() ) This is
deprecated since 0.1.6. Use cut_set_message() instead.
|
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 format string, followed by parameters to insert
into the format string. (as with printf() ) This is
deprecated since 0.1.6. Use cut_set_message() instead.
|
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 format string, followed by parameters to insert
into the format string. (as with printf() ) This is
deprecated since 0.1.6. Use cut_set_message() instead.
|
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 format string, followed by parameters to insert
into the format string. (as with printf() ) This is
deprecated since 0.1.6. Use cut_set_message() instead.
|
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 format string, followed by parameters to insert
into the format string. (as with printf() ) This is
deprecated since 0.1.6. Use cut_set_message() instead.
|
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 format string, followed by parameters to insert
into the format string. (as with printf() ) This is
deprecated since 0.1.6. Use cut_set_message() instead.
|
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 format string, followed by parameters to insert
into the format string. (as with printf() ) This is
deprecated since 0.1.6. Use cut_set_message() instead.
|
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 format string, followed by parameters to insert
into the format string. (as with printf() ) This is
deprecated since 0.1.6. Use cut_set_message() instead.
|
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 format string, followed by parameters to insert
into the format string. (as with printf() ) This is
deprecated since 0.1.6. Use cut_set_message() instead.
|
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 .
|
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 format string, followed by parameters to insert
into the format string. (as with printf() ) This is
deprecated since 0.1.6. Use cut_set_message() instead.
|
Since 1.0.4
void gcut_assert_error (GError *error, ...);
Passes if error
== NULL
.
|
a target GError. |
|
optional format string, followed by parameters to insert
into the format string. (as with printf() ) This is
deprecated since 0.1.6. Use cut_set_message() instead.
|
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 format string, followed by parameters to insert
into the format string. (as with printf() ) This is
deprecated since 0.1.6. Use cut_set_message() instead.
|
Since 1.0
void gcut_assert_equal_error (GError *expected, GError *actual, ...);
Passes if expected
== actual
.
|
an expected value. |
|
an actual value. |
|
optional format string, followed by parameters to insert
into the format string. (as with printf() ) This is
deprecated since 0.1.6. Use cut_set_message() instead.
|
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 format string, followed by parameters to insert
into the format string. (as with printf() ) This is
deprecated since 0.1.6. Use cut_set_message() instead.
|
Since 1.0.4
void gcut_assert_equal_enum (GType enum_type, gint expected, gint actual, ...);
Passes if expected
== actual
.
e.g.:
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 format string, followed by parameters to insert
into the format string. (as with printf() ) This is
deprecated since 0.1.6. Use cut_set_message() instead.
|
Since 1.0.5
void gcut_assert_equal_flags (GType flags_type, guint expected, guint actual, ...);
Passes if expected
== actual
.
e.g.:
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 format string, followed by parameters to insert
into the format string. (as with printf() ) This is
deprecated since 0.1.6. Use cut_set_message() instead.
|
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.:
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 format string, followed by parameters to insert
into the format string. (as with printf() ) This is
deprecated since 0.1.6. Use cut_set_message() instead.
|
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.:
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 format string, followed by parameters to insert
into the format string. (as with printf() ) This is
deprecated since 0.1.6. Use cut_set_message() instead.
|
Since 1.0.5
void gcut_assert_equal_int64 (gint64 expected, gint64 actual, ...);
Passes if expected
== actual
.
|
an expected value. |
|
an actual value. |
|
optional format string, followed by parameters to insert
into the format string. (as with printf() ) This is
deprecated since 0.1.6. Use cut_set_message() instead.
|
Since 1.0.5
void gcut_assert_equal_uint64 (guint64 expected, guint64 actual, ...);
Passes if expected
== actual
.
|
an expected value. |
|
an actual value. |
|
optional format string, followed by parameters to insert
into the format string. (as with printf() ) This is
deprecated since 0.1.6. Use cut_set_message() instead.
|
Since 1.0.5
void gcut_assert_equal_pid (GPid expected, GPid actual);
Passes if expected
== actual
.
|
an expected value. |
|
an actual value. |
Since 1.0.6