![]() |
![]() |
![]() |
Cutterリファレンスマニュアル | ![]() |
---|---|---|---|---|
#define cut_assert (expression, ...) #define cut_assert_true (expression, ...) #define cut_assert_false (expression, ...) #define cut_assert_null (expression, ...) #define cut_assert_null_string (expression, ...) #define cut_assert_not_null (expression, ...) #define cut_assert_equal_int (expected, actual, ...) #define cut_assert_equal_uint (expected, actual, ...) #define cut_assert_equal_double (expected, error, actual, ...) #define cut_assert_equal_string (expected, actual, ...) #define cut_assert_equal_string_with_free (expected, actual, ...) #define cut_assert_equal_string_or_null (expected, actual, ...) #define cut_assert_equal_memory (expected, expected_size, actual, actual_size, ...) #define cut_assert_equal_string_array (expected, actual, ...) #define cut_assert_equal_string_array_with_free(expected, actual, ...) #define cut_assert_operator (lhs, operator, rhs, ...) #define cut_assert_operator_int (lhs, operator, rhs, ...) #define cut_assert_equal (function, expected, actual, ...) #define cut_assert_errno (...) #define cut_assert_file_exist (path, ...) #define cut_assert_path_exist (path, ...) #define cut_assert_path_not_exist (path, ...) #define cut_assert_match (pattern, actual, ...) #define cut_assert_match_with_free (pattern, actual, ...) #define cut_assert_equal_pointer (expected, actual, ...) #define cut_assert_equal_fixture_data_string(expected, path, ...) #define cut_error (format, ...) #define cut_error_errno (...) #define cut_fail (format, ...) #define cut_pend (format, ...) #define cut_pending (format, ...) #define cut_notify (format, ...) #define cut_omit (format, ...)
あなたのプログラムが期待通りに動作しているかを検証するために、期待した値が得られていることを検証したい箇所でcut_assert_XXX()
を使います。
例:
cut_assert_equal_int(3, 1 + 2);
#define cut_assert_true(expression, ...)
expression
が真の値の(0でもNULLでもない)ときにパスします。
|
|
|
0.9から
#define cut_assert_false(expression, ...)
expression
が0かNULLのときにパスします。
|
|
|
0.9から
#define cut_assert_null(expression, ...)
expression
がNULLのときにパスします。
|
|
|
#define cut_assert_null_string(expression, ...)
expression
がNULLのときにパスします。
|
|
|
0.3から
#define cut_assert_not_null(expression, ...)
expression
がNULLではないときにパスします。
|
|
|
#define cut_assert_equal_int(expected, actual, ...)
expected
== actual
が成り立つときパスします。
|
|
|
|
|
#define cut_assert_equal_uint(expected, actual, ...)
expected
== actual
が成り立つときパスします。
|
|
|
|
|
#define cut_assert_equal_double(expected, error, actual, ...)
(expected
- error
) <= actual
<= (expected
+ error
)が成り立つときパスします。
|
|
|
|
|
|
|
#define cut_assert_equal_string(expected, actual, ...)
expected
とactual
がどちらともNULL、あるいはstrcmp(expected
, actual
) == 0が成り立つときにパスします。
|
|
|
|
|
#define cut_assert_equal_string_with_free(expected, actual, ...)
expected
とactual
がどちらともNULL、あるいはstrcmp(expected
, actual
) == 0が成り立つときにパスします。
|
|
|
|
|
0.3から
#define cut_assert_equal_string_or_null(expected, actual, ...)
cut_assert_equal_string_or_null
はバージョン0.3から非推奨になりました。新しく書くコードでは使わないでください。代わりにcut_assert_equal_string()
を使ってください。
expected
とactual
がどちらともNULL、あるいはstrcmp(expected
, actual
) == 0が成り立つときにパスします。
|
|
|
|
|
#define cut_assert_equal_memory(expected, expected_size, \ actual, actual_size, ...)
expected_size
== actual_size
が成り立ち、かつ、memcmp(expected
, actual
, expected_size
) == 0が成り立つときにパスします。
|
|
|
|
|
|
|
|
|
#define cut_assert_equal_string_array(expected, actual, ...)
expected
とactual
がどちらともNULLではなく、どちらも同じ内容の文字列(strcmp()
== 0)を持つときにパスします。
|
|
|
|
|
#define cut_assert_equal_string_array_with_free(expected, actual, ...)
expected
とactual
がどちらともNULLではなく、どちらも同じ内容の文字列(strcmp()
== 0)を持つときにパスします。
|
|
|
|
|
0.9から
#define cut_assert_operator(lhs, operator, rhs, ...)
(lhs
operator
rhs
)が真のときにパスします。
例:
cut_assert_operator(1, <, 2) -> (1 < 2);
|
|
|
|
|
|
|
#define cut_assert_operator_int(lhs, operator, rhs, ...)
(lhs
operator
rhs
)が真のときにパスします。
例:
cut_assert_operator_int(1, <, 2) -> (1 < 2);
|
|
|
|
|
|
|
#define cut_assert_equal(function, expected, actual, ...)
function
(expected
, actual
)が真を返すときパスします。
例:
cut_assert_equal(!strcmp, "abc", "abc"); -> Pass
|
|
|
|
|
|
|
#define cut_assert_errno(...)
errnoが0だとパスします。
例:
count = write(stdout, buffer, strlen(buffer)); cut_assert_errno("Failed to write"); -> Pass when count != -1
|
0.8から
#define cut_assert_file_exist(path, ...)
cut_assert_file_exist
はバージョン1.0.2から非推奨になりました。新しく書くコードでは使わないでください。代わりにcut_assert_path_exist()
を使ってください。
path
が存在するときにパスします。普通のファイルかもしれませんし、そうでないかもしれません。(例えばシンボリックリンクやディレクトリなど)
例:
cut_assert_file_exist("/tmp"); -> Pass on many environment cut_assert_file_exist("/non-existent"); -> Fail
|
|
|
0.9から
#define cut_assert_path_exist(path, ...)
path
が存在するときにパスします。普通のファイルかもしれませんし、そうでないかもしれません。(例えばシンボリックリンクやディレクトリなど)
例:
cut_assert_path_exist("/tmp"); -> Pass on many environment cut_assert_path_exist("/non-existent"); -> Fail
|
|
|
1.0.2から
#define cut_assert_path_not_exist(path, ...)
path
が存在しないとパスします。
例:
cut_assert_path_not_exist("/non-existent"); -> Pass on many environment cut_assert_path_not_exist("/tmp"); -> Fail
|
|
|
1.0.2から
#define cut_assert_match(pattern, actual, ...)
pattern
がstring
にマッチしたときパスします。
例:
cut_assert_match("^abc", "abc"); -> Pass cut_assert_match("^abc", " abc"); -> Fail
|
|
|
|
|
1.0から
#define cut_assert_match_with_free(pattern, actual, ...)
pattern
がstring
にマッチしたときパスします。詳細は
|
|
|
|
|
1.0から
#define cut_assert_equal_pointer(expected, actual, ...)
expected
== actual
が成り立つときパスします。
|
|
|
|
|
1.0から
#define cut_assert_equal_fixture_data_string(expected, path, ...)
expected
== cut_get_fixture_data_string(path
, ...)が成り立つときパスします。
|
|
|
|
|
1.0.2から
#define cut_error_errno(...)
例:
void setup (void) { mkdir("tmp", 0700); cut_error_errno("Failed to make tmp directory"); -> Error when tmp directory isn't made successfully. }
|
1.0.2から
#define cut_pending(format, ...)
cut_pending
はバージョン0.4から非推奨になりました。新しく書くコードでは使わないでください。代わりにcut_pend()
を使ってください。
メッセージ付きでこのテストが未解決であると印を付けます。テストはここで中断します。
|
|
|