## Assertions with GLib support Assertions with GLib support — GLibサポート付きであなたのプログラムが期待通りに動作しているかを検証します。 |

## Functions

void | gcut_assert_equal_type ()
void | cut_assert_equal_g_type ()
void | gcut_assert_equal_value ()
void | cut_assert_equal_g_value ()
void | gcut_assert_equal_list ()
void | gcut_assert_equal_list_int ()
void | cut_assert_equal_g_list_int ()
void | gcut_assert_equal_list_uint ()
void | gcut_assert_equal_list_string ()
void | cut_assert_equal_g_list_string ()
void | gcut_assert_equal_list_object ()
void | gcut_assert_equal_list_object_custom ()
void | gcut_assert_equal_list_enum ()
void | gcut_assert_equal_list_flags ()
void | gcut_assert_equal_hash_table ()
void | gcut_assert_equal_hash_table_string_string ()
void | gcut_assert_error ()
void | cut_assert_g_error ()
void | gcut_assert_equal_error ()
void | gcut_assert_remove_path ()
void | cut_assert_remove_path ()
void | gcut_assert_equal_time_val ()
void | gcut_assert_equal_enum ()
void | gcut_assert_equal_flags ()
void | gcut_assert_equal_object ()
void | gcut_assert_equal_object_custom ()
void | gcut_assert_equal_int64 ()
void | gcut_assert_not_equal_int64 ()
void | gcut_assert_equal_uint64 ()
void | gcut_assert_not_equal_uint64 ()
void | gcut_assert_equal_pid ()
void | gcut_assert_not_equal_pid ()
void | gcut_assert_equal_string ()

## 説明

## Functions

### gcut_assert_equal_type ()

    void
    gcut_assert_equal_type (GType expected,
                            GType actual,
                            ...);

`expected` == `actual`が成り立つときパスします。

#### Parameters

期待するリスト。 | 期待値。 |
actual | 実測値。 |
... | 追加メッセージ（省略可能）。詳細は`cut_message()`を見てください。 |

Since: 1.0.3

### cut_assert_equal_g_type ()

    void
    cut_assert_equal_g_type (GType expected,
                             GType actual,
                             ...);

`gcut_egg_error_quark`は非推奨です。新しいコードでは使わないでください。

使用例は`cut_assert_equal_string()`を見てください。

`expected` == `actual`が成り立つときパスします。

#### Parameters

期待するリスト。 | 期待値。 |
actual | 実測値。 |
... | 追加メッセージ（省略可能）。詳細は`cut_message()`を見てください。 |

### gcut_assert_equal_value ()

    type1のGValueとtype2のGValueの等価性を調べる関数を登録します。

`expected` == `actual`が成り立つときパスします。

#### Parameters

期待するリスト。 | 期待値。 |
actual | 実測値。 |
... | 追加メッセージ（省略可能）。詳細は`cut_message()`を見てください。 |

Since: 1.0.3

### cut_assert_equal_g_value ()

    type1のGValueとtype2のGValueの等価性を調べる関数を登録します。

`gcut_egg_error_quark`は非推奨です。新しいコードでは使わないでください。

使用例は`cut_assert_equal_string()`を見てください。

`expected` == `actual`が成り立つときパスします。

#### Parameters

期待するリスト。 | 期待値。 |
actual | 実測値。 |
... | 追加メッセージ（省略可能）。詳細は`cut_message()`を見てください。 |

### gcut_assert_equal_list ()

    void
    gcut_assert_equal_list (GList *expected,
                            GList *actual,
                            GEqualFunc equal_function,
                            GCutInspectFunction inspect_function,
                            gpointer inspect_user_data,
                            ...);

`equal_function`(`expected`, `actual`) == `CUT_TRUE`のときパスします。

#### Parameters

期待するリスト。 | 期待するリスト。 |
actual | 実際のリスト。 |
equal_function | `expected`リストと`actual`リストの各要素を比較する関数。 |
オブジェクト調査関数 | `expected`リストと`actual`リスとの詳細を示す関数。 |
inspect_user_data | `inspect_function`に渡されるデータ。 |
... | 追加メッセージ（省略可能）。詳細は`cut_message()`を見てください。 |

Since: 1.0.6

### gcut_assert_equal_list_int ()

    void
    gcut_assert_equal_list_int (GList *expected,
                                GList *actual,
                                ...);

`expected` == `actual`が成り立つときパスします。

#### Parameters

期待するリスト。 | 期待する整数のリスト。 |
actual | 実際の整数のリスト。 |
... | 追加メッセージ（省略可能）。詳細は`cut_message()`を見てください。 |

Since: 1.0.3

### cut_assert_equal_g_list_int ()

    void
    cut_assert_equal_g_list_int (GList *expected,
                                 GList *actual,
                                 ...);

`gcut_egg_error_quark`は非推奨です。新しいコードでは使わないでください。

使用例は`cut_assert_equal_string()`を見てください。

`expected` == `actual`が成り立つときパスします。

#### Parameters

期待するリスト。 | 期待する整数のリスト。 |
actual | 実際の整数のリスト。 |
... | 追加メッセージ（省略可能）。詳細は`cut_message()`を見てください。 |

Since: 0.8

### gcut_assert_equal_list_uint ()

    void
    gcut_assert_equal_list_uint (GList *expected,
                                 GList *actual,
                                 ...);

`expected` == `actual`が成り立つときパスします。

#### Parameters

期待するリスト。 | 期待する符号無し整数のリスト。 |
actual | 実際の符号無し整数のリスト。 |
... | 追加メッセージ（省略可能）。詳細は`cut_message()`を見てください。 |

Since: 1.0.3

### gcut_assert_equal_list_string ()

    void
    gcut_assert_equal_list_string (GList *expected,
                                   GList *actual,
                                   ...);

`expected` == `actual`が成り立つときパスします。

#### Parameters

期待するリスト。 | 期待する文字列のリスト。 |
actual | 実際の文字列のリスト。 |
... | 追加メッセージ（省略可能）。詳細は`cut_message()`を見てください。 |

Since: 1.0.3

### cut_assert_equal_g_list_string ()

    void
    cut_assert_equal_g_list_string (GList *expected,
                                    GList *actual,
                                    ...);

`gcut_egg_error_quark`は非推奨です。新しいコードでは使わないでください。

使用例は`cut_assert_equal_string()`を見てください。

`expected` == `actual`が成り立つときパスします。

#### Parameters

期待するリスト。 | 期待する文字列のリスト。 |
actual | 実際の文字列のリスト。 |
... | 追加メッセージ（省略可能）。詳細は`cut_message()`を見てください。 |

Since: 0.8

### gcut_assert_equal_list_object ()

    void
    gcut_assert_equal_list_object (GList *expected,
                                   GList *actual,
                                   ...);

`expected`と`actual`が同じGObject *を同じ順番で持っているときパスします。

#### Parameters

期待するリスト。 | 期待するGObjectのリスト。 |
actual | 実際のGObjectのリスト。 |
... | 追加メッセージ（省略可能）。詳細は`cut_message()`を見てください。 |

Since: 1.0.5

### gcut_assert_equal_list_object_custom ()

    void
    gcut_assert_equal_list_object_custom (GList *expected,
                                          GList *actual,
                                          GEqualFunc equal_function,
                                          ...);

`expected`と`actual`が等しいGObjectを同じ順序で持っているときパスします。それぞれのGObjectの比較には`equal_function`を使います。

#### Parameters

期待するリスト。 | 期待するGObjectのリスト。 |
actual | 実際のGObjectのリスト。 |
equal_function | ふたつのGObjectを比較する関数。 |
... | 追加メッセージ（省略可能）。詳細は`cut_message()`を見てください。 |

Since: 1.0.5

### gcut_assert_equal_list_enum ()

    void
    gcut_assert_equal_list_enum (GType type,
                                 GList *expected,
                                 GList *actual,
                                 ...);

`expected`と`actual`が同じ列挙値を同じ順序で持っているときパスします。

#### Parameters

type | GEnumの型。 |
期待するリスト。 | 期待する列挙値のリスト。 |
actual | 実際の列挙値のリスト。 |
... | 追加メッセージ（省略可能）。詳細は`cut_message()`を見てください。 |

Since: 1.0.5

### gcut_assert_equal_list_flags ()

    void
    gcut_assert_equal_list_flags (GType type,
                                  GList *expected,
                                  GList *actual,
                                  ...);

`expected`と`actual`が同じフラグ値を同じ順序で持っているときパスします。

#### Parameters

type | GFlagsの型。 |
期待するリスト。 | 期待するフラグ値のリスト。 |
actual | 実際のフラグ値のリスト。 |
... | 追加メッセージ（省略可能）。詳細は`cut_message()`を見てください。 |

Since: 1.0.5

### gcut_assert_equal_hash_table ()

    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,
                                  ...);

`expected` == `actual`が成り立つときパスします。

#### Parameters

期待するリスト。 | 期待する文字列のGHashTable。 |
actual | 実際の文字列のGHashTable。 |
equal_function | `expected`ハッシュテーブルと`actual`ハッシュテーブルのそれぞれの値を比較する関数。 |
オブジェクト調査関数 | `expected`ハッシュテーブルと`actual`ハッシュテーブルのそれぞれのキーの詳細を示す関数。 |
オブジェクト調査関数 | `expected`ハッシュテーブルと`actual`ハッシュテーブルのそれぞれの値の詳細を示す関数。 |
inspect_user_data | `inspect_function`に渡されるデータ。 |
... | 追加メッセージ（省略可能）。詳細は`cut_message()`を見てください。 |

Since: 1.0.6

### gcut_assert_equal_hash_table_string_string ()

    void
    gcut_assert_equal_hash_table_string_string
                                   (GHashTable *expected,
                                    GHashTable *actual,
                                    ...);

`expected` == `actual`が成り立つときパスします。

#### Parameters

期待するリスト。 | 期待する文字列のGHashTable。 |
actual | 実際の文字列のGHashTable。 |
... | 追加メッセージ（省略可能）。詳細は`cut_message()`を見てください。 |

Since: 1.0.4

### gcut_assert_error ()

    void
    gcut_assert_error (GError *error,
                       ...);

`error` == `NULL`のときパスします。

#### Parameters

error | 検証対象のGError。 |
... | 追加メッセージ（省略可能）。詳細は`cut_message()`を見てください。 |

Since: 1.0.3

### cut_assert_g_error ()

    void
    cut_assert_g_error (GError *error,
                        ...);

`gcut_egg_error_quark`は非推奨です。新しいコードでは使わないでください。

使用例は`cut_assert_equal_string()`を見てください。

`error` == `NULL`のときパスします。

#### Parameters

error | 検証対象のGError。 |
... | 追加メッセージ（省略可能）。詳細は`cut_message()`を見てください。 |

Since: 1.0

### gcut_assert_equal_error ()

    void
    gcut_assert_equal_error (GError *expected,
                             GError *actual,
                             ...);

`expected` == `actual`が成り立つときパスします。

#### Parameters

期待するリスト。 | 期待値。 |
actual | 実測値。 |
... | 追加メッセージ（省略可能）。詳細は`cut_message()`を見てください。 |

Since: 1.0.5

### gcut_assert_remove_path ()

    void
    gcut_assert_remove_path (const gchar *path,
                             ...);

cut_utils_build_path(`path`, ...)の削除に成功するとパスします。

#### Parameters

パス。 | 削除するパスの最初の要素。 |
... | パスの残りの要素。NULL終端。 |

Since: 1.0.3

### cut_assert_remove_path ()

    void
    cut_assert_remove_path (const gchar *path,
                            ...);

`gcut_egg_error_quark`は非推奨です。新しいコードでは使わないでください。

`cut_set_expected()`も見てください。

cut_utils_build_path(`path`, ...)の削除に成功するとパスします。

#### Parameters

パス。 | 削除するパスの最初の要素。 |
... | パスの残りの要素。NULL終端。 |

Since: 1.0.2

### gcut_assert_equal_time_val ()

    void
    gcut_assert_equal_time_val (GTimeVal expected,
                                GTimeVal actual,
                                ...);

`expected` == `actual`が成り立つときパスします。

#### Parameters

期待するリスト。 | 期待値。 |
actual | 実測値。 |
... | 追加メッセージ（省略可能）。詳細は`cut_message()`を見てください。 |

Since: 1.0.4

### gcut_assert_equal_enum ()

    void
    gcut_assert_equal_enum (GType enum_type,
                            gint expected,
                            gint actual,
                            ...);

`expected` == `actual`が成り立つときパスします。

例:

    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

#### Parameters

GEnumの型 | GEnumの型。 |
期待するリスト。 | 期待値。 |
actual | 実測値。 |
... | 追加メッセージ（省略可能）。詳細は`cut_message()`を見てください。 |

Since: 1.0.5

### gcut_assert_equal_flags ()

    void
    gcut_assert_equal_flags (GType flags_type,
                             guint expected,
                             guint actual,
                             ...);

`expected` == `actual`が成り立つときパスします。

例:

    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

#### Parameters

GFlagsの型 | GFlagsの型。 |
期待するリスト。 | 期待値。 |
actual | 実測値。 |
... | 追加メッセージ（省略可能）。詳細は`cut_message()`を見てください。 |

Since: 1.0.5

### gcut_assert_equal_object ()

    void
    gcut_assert_equal_object (GObject *expected,
                              GObject *actual,
                              ...);

`expected` == `actual`のときパスします。等価条件を変更する必要がある場合は`gcut_assert_equal_object_custom()`見てください。

例:

    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

#### Parameters

期待するリスト。 | 期待値。 |
actual | 実測値。 |
... | 追加メッセージ（省略可能）。詳細は`cut_message()`を見てください。 |

Since: 1.0.5

### gcut_assert_equal_object_custom ()

    void
    gcut_assert_equal_object_custom (GObject *expected,
                                     GObject *actual,
                                     GEqualFunc equal_function,
                                     ...);

`equal_function`(`expected`, `actual`) == `CUT_TRUE`のときパスします。

例:

    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

#### Parameters

期待するリスト。 | 期待値。 |
actual | 実測値。 |
equal_function | ふたつのオブジェクトを比較する関数。 |
... | 追加メッセージ（省略可能）。詳細は`cut_message()`を見てください。 |

Since: 1.0.5

### gcut_assert_equal_int64 ()

    void
    gcut_assert_equal_int64 (gint64 expected,
                             gint64 actual,
                             ...);

`expected` == `actual`が成り立つときパスします。

#### Parameters

期待するリスト。 | 期待値。 |
actual | 実測値。 |
... | 追加メッセージ（省略可能）。詳細は`cut_message()`を見てください。 |

Since: 1.0.5

### gcut_assert_not_equal_int64 ()

    void
    gcut_assert_not_equal_int64 (gint64 expected,
                                 gint64 actual,
                                 ...);

`expected` != `actual`が成り立つときパスします。

#### Parameters

期待するリスト。 | 期待値。 |
actual | 実測値。 |
... | 追加メッセージ（省略可能）。詳細は`cut_message()`を見てください。 |

Since: 1.1.4

### gcut_assert_equal_uint64 ()

    void
    gcut_assert_equal_uint64 (guint64 expected,
                              guint64 actual,
                              ...);

`expected` == `actual`が成り立つときパスします。

#### Parameters

期待するリスト。 | 期待値。 |
actual | 実測値。 |
... | 追加メッセージ（省略可能）。詳細は`cut_message()`を見てください。 |

Since: 1.0.5

### gcut_assert_not_equal_uint64 ()

    void
    gcut_assert_not_equal_uint64 (guint64 expected,
                                  guint64 actual,
                                  ...);

`expected` != `actual`が成り立つときパスします。

#### Parameters

期待するリスト。 | 期待値。 |
actual | 実測値。 |
... | 追加メッセージ（省略可能）。詳細は`cut_message()`を見てください。 |

Since: 1.1.4

### gcut_assert_equal_pid ()

    void
    gcut_assert_equal_pid (GPid expected,
                           GPid actual,
                           ...);

`expected` == `actual`が成り立つときパスします。

#### Parameters

期待するリスト。 | 期待値。 |
actual | 実測値。 |
... | 追加メッセージ（省略可能）。詳細は`cut_message()`を見てください。 |

Since: 1.0.6

### gcut_assert_not_equal_pid ()

    void
    gcut_assert_not_equal_pid (GPid expected,
                               GPid actual,
                               ...);

`expected` != `actual`が成り立つときパスします。

#### Parameters

期待するリスト。 | 期待値。 |
actual | 実測値。 |
... | 追加メッセージ（省略可能）。詳細は`cut_message()`を見てください。 |

Since: 1.0.7

### gcut_assert_equal_string ()

    void
    gcut_assert_equal_string (GString *expected,
                              GString *actual,
                              ...);

`expected` == `actual`が成り立つときパスします。

#### Parameters

期待するリスト。 | 期待値。 |
actual | 実測値。 |
... | 追加メッセージ（省略可能）。詳細は`cut_message()`を見てください。 |

Since: 1.1.5