![]() |
![]() |
![]() |
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_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_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 gcut_assert_remove_path_helper (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_time_val_helper (GTimeVal *expected
,GTimeVal *actual
,const gchar *expression_expected
,const gchar *actual_expected
); 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_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_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_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 gcut_assert_remove_path_helper (const gchar *path
,...
);
|
|
|
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_time_val_helper (GTimeVal *expected
,GTimeVal *actual
,const gchar *expression_expected
,const gchar *actual_expected
);
|
|
|
|
|
|
|
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_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