| 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()を使ってください。
メッセージ付きでこのテストが未解決であると印を付けます。テストはここで中断します。
|
|
|