名称

書式

ATF_CHECK( expression);

ATF_CHECK_MSG( expression, fail_msg_fmt, ...);

ATF_CHECK_EQ( expression_1, expression_2);

ATF_CHECK_EQ_MSG( expression_1, expression_2, fail_msg_fmt, ...);

ATF_CHECK_STREQ( string_1, string_2);

ATF_CHECK_STREQ_MSG( string_1, string_2, fail_msg_fmt, ...);

ATF_CHECK_ERRNO( exp_errno, bool_expression);

ATF_REQUIRE( expression);

ATF_REQUIRE_MSG( expression, fail_msg_fmt, ...);

ATF_REQUIRE_EQ( expression_1, expression_2);

ATF_REQUIRE_EQ_MSG( expression_1, expression_2, fail_msg_fmt, ...);

ATF_REQUIRE_STREQ( string_1, string_2);

ATF_REQUIRE_STREQ_MSG( string_1, string_2, fail_msg_fmt, ...);

ATF_REQUIRE_ERRNO( exp_errno, bool_expression);

ATF_TC( name);

ATF_TC_BODY( name, tc);

ATF_TC_BODY_NAME( name);

ATF_TC_CLEANUP( name, tc);

ATF_TC_CLEANUP_NAME( name);

ATF_TC_HEAD( name, tc);

ATF_TC_HEAD_NAME( name);

ATF_TC_NAME( name);

ATF_TC_WITH_CLEANUP( name);

ATF_TC_WITHOUT_HEAD( name);

ATF_TP_ADD_TC( tp_name, tc_name);

ATF_TP_ADD_TCS( tp_name);

atf_tc_get_config_var( tc, varname);

atf_tc_get_config_var_wd( tc, variable_name, default_value);

atf_tc_get_config_var_as_bool( tc, variable_name);

atf_tc_get_config_var_as_bool_wd( tc, variable_name, default_value);

atf_tc_get_config_var_as_long( tc, variable_name);

atf_tc_get_config_var_as_long_wd( tc, variable_name, default_value);

atf_no_error();

atf_tc_expect_death( reason, ...);

atf_tc_expect_exit( exitcode, reason, ...);

atf_tc_expect_fail( reason, ...);

atf_tc_expect_pass();

atf_tc_expect_signal( signo, reason, ...);

atf_tc_expect_timeout( reason, ...);

atf_tc_fail( reason);

atf_tc_fail_nonfatal( reason);

atf_tc_pass();

atf_tc_skip( reason);

解説

... C 特有のインクルードは, ここに ... 
 
#include <atf-c.h> 
 
ATF_TC(tc1); 
ATF_TC_HEAD(tc1, tc) 
{ 
    ... 最初のテストケースのヘッダ ... 
} 
ATF_TC_BODY(tc1, tc) 
{ 
    ... 最初のテストケースの本体 ... 
} 
 
ATF_TC_WITH_CLEANUP(tc2); 
ATF_TC_HEAD(tc2, tc) 
{ 
    ... 2 番目のテストケースのヘッダ ... 
} 
ATF_TC_BODY(tc2, tc) 
{ 
    ... 2 番目のテストケースの本体 ... 
} 
ATF_TC_CLEANUP(tc2, tc) 
{ 
    ... 2 番目のテストケースのクリーンアップ ... 
} 
 
ATF_TC_WITHOUT_HEAD(tc3); 
ATF_TC_BODY(tc3, tc) 
{ 
    ... 3 番目のテストケースの本体 ... 
} 
 
... 追加のテストケース ... 
 
ATF_TP_ADD_TCS(tp) 
{ 
    ATF_TP_ADD_TC(tcs, tc1); 
    ATF_TP_ADD_TC(tcs, tc2); 
    ATF_TP_ADD_TC(tcs, tc3); 
    ... 追加のテストケースを追加する ... 
 
    return atf_no_error(); 
}

使用例

#include <atf-c.h> 
 
ATF_TC(addition); 
ATF_TC_HEAD(addition, tc) 
{ 
    atf_tc_set_md_var(tc, "descr", 
                      "Sample tests for the addition operator"); 
} 
ATF_TC_BODY(addition, tc) 
{ 
    ATF_CHECK_EQ(0 + 0, 0); 
    ATF_CHECK_EQ(0 + 1, 1); 
    ATF_CHECK_EQ(1 + 0, 1); 
 
    ATF_CHECK_EQ(1 + 1, 2); 
 
    ATF_CHECK_EQ(100 + 200, 300); 
} 
 
ATF_TC(string_formatting); 
ATF_TC_HEAD(string_formatting, tc) 
{ 
    atf_tc_set_md_var(tc, "descr", 
                      "Sample tests for the snprintf"); 
} 
ATF_TC_BODY(string_formatting, tc) 
{ 
    char buf[1024]; 
    snprintf(buf, sizeof(buf), "a %s", "string"); 
    ATF_CHECK_STREQ_MSG("a string", buf, "%s is not working"); 
} 
 
ATF_TC(open_failure); 
ATF_TC_HEAD(open_failure, tc) 
{ 
    atf_tc_set_md_var(tc, "descr", 
                      "Sample tests for the open function"); 
} 
ATF_TC_BODY(open_failure, tc) 
{ 
    ATF_CHECK_ERRNO(ENOENT, open("non-existent", O_RDONLY) == -1); 
} 
 
ATF_TC(known_bug); 
ATF_TC_HEAD(known_bug, tc) 
{ 
    atf_tc_set_md_var(tc, "descr", 
                      "Reproduces a known bug"); 
} 
ATF_TC_BODY(known_bug, tc) 
{ 
    atf_tc_expect_fail("See bug number foo/bar"); 
    ATF_CHECK_EQ(3, 1 + 1); 
    atf_tc_expect_pass(); 
    ATF_CHECK_EQ(3, 1 + 2); 
} 
 
ATF_TP_ADD_TCS(tp) 
{ 
    ATF_TP_ADD_TC(tp, addition); 
    ATF_TP_ADD_TC(tp, string_formatting); 
    ATF_TP_ADD_TC(tp, open_failure); 
    ATF_TP_ADD_TC(tp, known_bug); 
 
    return atf_no_error(); 
}

関連項目