Assertion Utilities for GEnum and GFlags

Assertion Utilities for GEnum and GFlags — Utilities to write assertions related to GEnum or GFlags more easily.

Synopsis

gboolean            gcut_enum_equal                     (GType enum_type,
                                                         gint enum1,
                                                         gint enum2);
gchar*              gcut_enum_inspect                   (GType enum_type,
                                                         gint enum_value);
gboolean            gcut_flags_equal                    (GType flags_type,
                                                         guint flags1,
                                                         guint flags2);
gchar*              gcut_flags_inspect                  (GType flags_type,
                                                         guint flags);

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 GEnum or GFlags.

Details

gcut_enum_equal ()

gboolean            gcut_enum_equal                     (GType enum_type,
                                                         gint enum1,
                                                         gint enum2);

Compares two enum_type values, enum1 and enum2.

enum_type :

a GEnum type.

enum1 :

a GEnum value to be compared.

enum2 :

a GEnum value to be compared.

Returns :

TRUE if enum1 == enum2, FALSE otherwise.

Since 1.0.5


gcut_enum_inspect ()

gchar*              gcut_enum_inspect                   (GType enum_type,
                                                         gint enum_value);

Inspects enum_type value, enum_value. The returned string should be freed when no longer needed.

enum_type :

a GEnum type.

enum_value :

a GEnum value to be inspected.

Returns :

inspected enum_value as a string.

Since 1.0.5


gcut_flags_equal ()

gboolean            gcut_flags_equal                    (GType flags_type,
                                                         guint flags1,
                                                         guint flags2);

Compares two flags_type values, flags1 and flags2.

flags_type :

a GFlags type.

flags1 :

a GFlags value to be compared.

flags2 :

a GFlags value to be compared.

Returns :

TRUE if flags1 == flags2, FALSE otherwise.

Since 1.0.5


gcut_flags_inspect ()

gchar*              gcut_flags_inspect                  (GType flags_type,
                                                         guint flags);

Inspects flags_type value, flags_value. The returned string should be freed when no longer needed.

flags_type :

a GFlags type.

flags :

Returns :

inspected flags_value as a string.

Since 1.0.5