![]() |
![]() |
![]() |
Cutterリファレンスマニュアル | ![]() |
---|---|---|---|---|
#define cut_take (object, destroy_function) #define cut_take_memory (memory) #define cut_take_string (string) #define cut_take_strdup (string) #define cut_take_strndup (string, size) #define cut_take_memdup (memory, size) #define cut_take_printf (format, ...) #define cut_take_string_array (strings) #define cut_take_diff (from, to) #define cut_append_diff (message, from, to) #define cut_inspect_string_array (strings) #define cut_set_fixture_data_dir (path, ...) #define cut_build_fixture_data_path (path, ...) #define cut_get_fixture_data_string (path, ...) #define cut_remove_path (path, ...) #define cut_equal_string (string1, string2) #define cut_equal_double (double1, double2, error)
テストを書くためには、テスト環境を前処理・後処理するコードや、検証する結果を準備するコードなどたくさんのコードを書く必要があります。Cutterはもっと簡単にテストを書くためにユーティリティを提供します。
このユーティリティはGLibサポート無しでも使えます。
#define cut_take(object, destroy_function)
オブジェクトの所有権をCutterに渡し、オブジェクト自身を返します。object
はdestroy_func
を用いて破棄されます。
|
Cutterが所有権をもつことになるオブジェクト。 |
|
オブジェクト用の破棄関数。 |
1.0.5から
#define cut_take_memory(memory)
メモリの所有権をCutterに渡し、メモリ自身を返します。memory
はfree()
で破棄されます。
|
Cutterが所有権を持つことになるメモリ。(void *) |
1.0.5から
#define cut_take_string(string)
文字列の所有権をCutterに渡し、文字列それ自身を返します。
|
Cutterが所有権も持つことになる文字列。 |
#define cut_take_strdup(string)
Duplicates the string, passes ownership of the duplicated string to Cutter and returns the duplicated string.
|
複製される文字列。(const char *) |
1.0.5から
#define cut_take_strndup(string, size)
文字列の先頭size
バイトを複製し、その所有権ををCutterに渡し、複製された文字列を返します。複製された文字列は常にNULL終端しています。
|
複製される文字列。(const char *) |
|
複製するバイト数。(size_t) |
1.0.5から
#define cut_take_memdup(memory, size)
メモリのsize
バイトを複製し、その所有権をCutterに渡し、複製されたメモリを返します。
|
複製されるメモリ。(void *) |
|
複製するバイト数。(size_t) |
1.0.5から
#define cut_take_printf(format, ...)
printf()
のように文字列を整形しますが、整形された文字列はCutterが所有します。
|
整形文字列。printf() のドキュメントを見てください。 |
|
整形文字列に挿入されるパラメータ。 |
#define cut_take_string_array(strings)
文字列の配列(char **)の所有権をCutterに渡し、strings
と同じ内容の文字列の配列を返します。
|
Cutterが所有する文字列の配列。 |
#define cut_take_diff(from, to)
from
とto
のdiffを計算します。diffの所有者はCutterです。
|
元の文字列。 |
|
修正された文字列。 |
#define cut_append_diff(message, from, to)
from
とto
のdiffを計算し、そのdiffをmessage
に追加します。戻り値の文字列の所有者はCutterです。
|
diffが追加される文字列。 |
|
元の文字列。 |
|
修正された文字列。 |
1.0.3から
#define cut_inspect_string_array(strings)
strings
を人が読みやすい文字列に整形します。整形された文字列の所有者はCutterです。
|
対象となる文字列の配列。 |
#define cut_set_fixture_data_dir(path, ...)
cut_get_fixture_data_string()
などで使われるフィクスチャデータのディレクトリを指定します。
|
フィクスチャデータディレクトリのパスの最初の要素。 |
|
パスの残りの要素。 |
1.0.2から
#define cut_build_fixture_data_path(path, ...)
フィクスチャデータへのパスを生成します。もし、path
が相対パスなら、パスはcut_set_fixture_data_dir()
で指定したディレクトリか、現在のディレクトリからの相対パスとして処理されます。
|
フィクスチャデータのパスの最初の要素。 |
|
パスの残りの要素。 |
1.0.2から
#define cut_get_fixture_data_string(path, ...)
"path
/..."にあるフィクスチャデータを読み込み、文字列として返します。文字列はCutterが所持します。cut_build_fixture_data_path()
の説明にはフィクスチャデータのパスがどのように決定されるかが書かれています。
|
フィクスチャデータのパスの最初の要素。 |
|
パスの残りの要素。 |
1.0.2から
#define cut_remove_path(path, ...)
path
と、その下にあるパスを再帰的に削除します。いかなるエラーも報告しません。
|
削除するパスの最初の要素。 |
|
パスの残りの要素。 |
1.0.2から
#define cut_equal_string(string1, string2)
string1
とstring2
を比較します。string1
あるいはstring2
、または両方がNULLでもかまいません。
|
文字列。 (char *) |
|
文字列。 (char *) |
1.0.5から