GLibサポート付きの検証 3 Cutterライブラリ
GLibサポート付きの検証 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,
                            ...);

Passes if expected == actual .

#### Parameters

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

1.0.3から

gcut_assert_equal_type

### cut_assert_equal_g_type ()

    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 .

#### Parameters

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

cut_assert_equal_g_type

### gcut_assert_equal_value ()

    void
    gcut_assert_equal_value (GValue *expected,
                             GValue *actual,
                             ...);

Passes if expected == actual .

#### Parameters

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

1.0.3から

gcut_assert_equal_value

### cut_assert_equal_g_value ()

    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 .

#### Parameters

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

cut_assert_equal_g_value

### gcut_assert_equal_list ()

    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`.

#### Parameters

expected | 期待するリスト。 |
actual | 実際のリスト。 |
equal_function | expectedリストとactualリストの各要素を比較する関数。 |
inspect_function | expectedリストとactualリスとの詳細を示す関数。 |
inspect_user_data | a data to be passed to inspect_function . |
... | 追加メッセージ（省略可能）。詳細は`cut_message()`を見てください。 |

1.0.6から

gcut_assert_equal_list

### gcut_assert_equal_list_int ()

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

Passes if expected == actual .

#### Parameters

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

1.0.3から

gcut_assert_equal_list_int

### cut_assert_equal_g_list_int ()

    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 .

#### Parameters

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

0.8から

cut_assert_equal_g_list_int
cut_assert_equal_g_list_int

### gcut_assert_equal_list_uint ()

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

Passes if expected == actual .

#### Parameters

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

1.0.3から

gcut_assert_equal_list_uint

### gcut_assert_equal_list_string ()

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

Passes if expected == actual .

#### Parameters

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

1.0.3から

gcut_assert_equal_list_string

### cut_assert_equal_g_list_string ()

    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 .

#### Parameters

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

0.8から

cut_assert_equal_g_list_string
cut_assert_equal_g_list_string

### gcut_assert_equal_list_object ()

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

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

#### Parameters

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

1.0.5から

gcut_assert_equal_list_object

### gcut_assert_equal_list_object_custom ()

    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 .

#### Parameters

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

1.0.5から

gcut_assert_equal_list_object_custom

### gcut_assert_equal_list_enum ()

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

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

#### Parameters

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

1.0.5から

gcut_assert_equal_list_enum

### gcut_assert_equal_list_flags ()

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

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

#### Parameters

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

1.0.5から

gcut_assert_equal_list_flags

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

Passes if expected == actual .

#### Parameters

expected | 期待する文字列のGHashTable。 |
actual | 実際の文字列のGHashTable。 |
equal_function | expectedハッシュテーブルとactualハッシュテーブルのそれぞれの値を比較する関数。 |
key_inspect_function | expectedハッシュテーブルとactualハッシュテーブルのそれぞれのキーの詳細を示す関数。 |
value_inspect_function | expectedハッシュテーブルとactualハッシュテーブルのそれぞれの値の詳細を示す関数。 |
inspect_user_data | a data to be passed to inspect_function . |
... | 追加メッセージ（省略可能）。詳細は`cut_message()`を見てください。 |

1.0.6から

gcut_assert_equal_hash_table

### gcut_assert_equal_hash_table_string_string ()

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

Passes if expected == actual .

#### Parameters

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

1.0.4から

gcut_assert_equal_hash_table_string_string

### gcut_assert_error ()

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

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

#### Parameters

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

1.0.3から

gcut_assert_error

### cut_assert_g_error ()

    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.

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

#### Parameters

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

1.0から

cut_assert_g_error
cut_assert_g_error

### gcut_assert_equal_error ()

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

Passes if expected == actual .

#### Parameters

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

1.0.5から

gcut_assert_equal_error

### gcut_assert_remove_path ()

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

Passes if cut_utils_build_path(path , ...) is removed successfully.

#### Parameters

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

1.0.3から

gcut_assert_remove_path

### cut_assert_remove_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.

#### Parameters

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

1.0.2から

cut_assert_remove_path
cut_assert_remove_path

### gcut_assert_equal_time_val ()

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

Passes if expected == actual .

#### Parameters

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

1.0.4から

gcut_assert_equal_time_val

### gcut_assert_equal_enum ()

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

Passes if expected == actual .

例:

    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

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

1.0.5から

gcut_assert_equal_enum

### gcut_assert_equal_flags ()

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

Passes if expected == actual .

例:

    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

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

1.0.5から

gcut_assert_equal_flags

### gcut_assert_equal_object ()

    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.

例:

    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

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

1.0.5から

gcut_assert_equal_object

### gcut_assert_equal_object_custom ()

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

Passes if equal_function (expected , actual ) == `CUT_TRUE`.

例:

    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

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

1.0.5から

gcut_assert_equal_object_custom

### gcut_assert_equal_int64 ()

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

Passes if expected == actual .

#### Parameters

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

1.0.5から

gcut_assert_equal_int64

### gcut_assert_not_equal_int64 ()

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

Passes if expected != actual .

#### Parameters

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

1.1.4から

gcut_assert_not_equal_int64

### gcut_assert_equal_uint64 ()

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

Passes if expected == actual .

#### Parameters

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

1.0.5から

gcut_assert_equal_uint64

### gcut_assert_not_equal_uint64 ()

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

Passes if expected != actual .

#### Parameters

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

1.1.4から

gcut_assert_not_equal_uint64

### gcut_assert_equal_pid ()

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

Passes if expected == actual .

#### Parameters

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

1.0.6から

gcut_assert_equal_pid

### gcut_assert_not_equal_pid ()

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

Passes if expected != actual .

#### Parameters

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

1.0.7から

gcut_assert_not_equal_pid

### gcut_assert_equal_string ()

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

Passes if expected == actual .

#### Parameters

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

1.1.5から

gcut_assert_equal_string

## Types and Values