![]() |
![]() |
![]() |
Cutterリファレンスマニュアル | ![]() |
---|---|---|---|---|
Top | 説明 |
void gcut_add_datum (const gchar *name, const gchar *first_field_name, ...); const gchar * gcut_data_get_string (gconstpointer data, const gchar *field_name); gint gcut_data_get_int (gconstpointer data, const gchar *field_name); guint gcut_data_get_uint (gconstpointer data, const gchar *field_name); GType gcut_data_get_type (gconstpointer data, const gchar *field_name); guint gcut_data_get_flags (gconstpointer data, const gchar *field_name); gint gcut_data_get_enum (gconstpointer data, const gchar *field_name); gconstpointer gcut_data_get_pointer (gconstpointer data, const gchar *field_name); gconstpointer gcut_data_get_boxed (gconstpointer data, const gchar *field_name); gpointer gcut_data_get_object (gconstpointer data, const gchar *field_name);
cut_add_data()
で複雑なテストデータを使用したい場合はテストデータ用にデータ型を定義する必要があります。しかし、それは少し面倒です。gcut_add_datum()
はデータ型を定義せずに複雑なテストデータを使用するためのAPIを提供します。このAPIは複雑なデータを扱うためにGTypeを使います。
void gcut_add_datum (const gchar *name, const gchar *first_field_name, ...);
データ駆動テスト用のデータを追加します。複雑なテストデータのために新しく構造体を定義する必要がないため、cut_add_data()
よりも便利です。
例:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 |
#include <gcutter.h> void data_translate (void); void test_translate (gconstpointer data); static const gchar* translate (gint input) { switch(input) { case 1: return "first"; case 111: return "a hundred eleven"; default: return "unsupported"; } } void data_translate(void) { gcut_add_datum("simple data", "translated", G_TYPE_STRING, "first", "input", G_TYPE_INT, 1, NULL); gcut_add_datum("complex data", "translated", G_TYPE_STRING, "a hundred eleven", "input", G_TYPE_INT, 111, NULL); } void test_translate(gconstpointer data) { cut_assert_equal_string(gcut_data_get_string(data, "translated"), gcut_data_get_int(data, "input")); } |
利用可能な型とその時の値は以下の通りです。
const gchar *value 例:
|
|||
gint value 例:
|
|||
guint value 例:
|
|||
GType value 例:
|
|||
GFlagsの型 |
その型の値。 例:
|
||
GEnumの型 |
その型の値。 例:
|
||
gconstpointer value, GDestroyNotify notify valueが破棄されるときにnotifyが呼ばれます。 例:
注意: 値の所有者はCutterになります。解放しないで下さい。 |
|||
GBoxedの型 |
その型の値。 例:
注意: 値の所有者はCutterになります。解放しないで下さい。 |
|
データの名前。 |
|
最初のフィールド名。 |
|
最初のフィールドの型と値。その後に、フィールドの名前と型と値の3つを任意の数だけ指定します。最後の引数はNULL にしてください。詳細は関数の説明文のところにあります。 |
1.0.6から
const gchar * gcut_data_get_string (gconstpointer data, const gchar *field_name);
field_name
フィールドの値を文字列として取得します。
|
gcut_add_datum() で追加したデータ。 |
|
フィールド名。 |
戻り値 : |
field_name に対応するフィールドの値。 |
1.0.6から
gint gcut_data_get_int (gconstpointer data, const gchar *field_name);
field_name
フィールドの値を整数として取得します。
|
gcut_add_datum() で追加したデータ。 |
|
フィールド名。 |
戻り値 : |
field_name に対応するフィールドの値。 |
1.0.6から
guint gcut_data_get_uint (gconstpointer data, const gchar *field_name);
field_name
の値を符号なし整数として取得します。
|
gcut_add_datum() で追加したデータ。 |
|
フィールド名。 |
戻り値 : |
field_name に対応するフィールドの値。 |
1.0.6から
GType gcut_data_get_type (gconstpointer data, const gchar *field_name);
field_name
フィールドの値をGTypeとして取得します。
|
gcut_add_datum() で追加したデータ。 |
|
フィールド名。 |
戻り値 : |
field_name に対応するフィールドの値。 |
1.0.6から
guint gcut_data_get_flags (gconstpointer data, const gchar *field_name);
field_name
の値をGFlags型の符号なし整数として取得します。
|
gcut_add_datum() で追加したデータ。 |
|
フィールド名。 |
戻り値 : |
field_name に対応するフィールドの値。 |
1.0.6から
gint gcut_data_get_enum (gconstpointer data, const gchar *field_name);
field_name
フィールドの値をGEnum型の整数として取得します。
|
gcut_add_datum() で追加したデータ。 |
|
フィールド名。 |
戻り値 : |
field_name に対応するフィールドの値。 |
1.0.6から
gconstpointer gcut_data_get_pointer (gconstpointer data, const gchar *field_name);
field_name
の値をポインタとして取得します。
|
gcut_add_datum() で追加したデータ。 |
|
フィールド名。 |
戻り値 : |
field_name に対応するフィールドの値。 |
1.0.6から
gconstpointer gcut_data_get_boxed (gconstpointer data, const gchar *field_name);
field_name
フィールドの値をGBoxed型の値として取得します。
|
gcut_add_datum() で追加したデータ。 |
|
フィールド名。 |
戻り値 : |
field_name に対応するフィールドの値。 |
1.0.7から
gpointer gcut_data_get_object (gconstpointer data, const gchar *field_name);
field_name
フィールドの値をGObjectとして取得します。
|
gcut_add_datum() で追加したデータ。 |
|
フィールド名。 |
戻り値 : |
field_name に対応するフィールドの値。 |
1.1.1から