前面介绍了check的一些基本数据结构,下面从一个简单的实例开始说说check的用法,并通过用法摸索一下他的结构。
下面是check自身的一个单元测试:
#include <stdlib.h>
#include <stdio.h>
#include <check.h>
Suite *s;
TCase *tc;
SRunner *sr;
// 测试函数定义方式,需要自己编写,check通过宏提供了一个测试函数的定义接口,能够更方便的定义测试函数,当然函数的内容得自己编写。
START_TEST(test_pass)
{
// 断言,在测试函数中使用(当然也可以在setup和teardown中使用),用于检查条件并生成事件。
fail_unless(1, "Shouldn't see this message");
}END_TEST
// 同上
START_TEST(test_fail)
{
// 另一个断言
fail("This test fails");
}END_TEST
// 运行函数了
static void run(int num_iters)
{
int i;
// 创建suite
s = suite_create("Stress");
// 创建test case,并把test case加入suite中
tc = tcase_create("Stress");
// 创建SRunner并加入test suite
sr = srunner_create(s);
suite_add_tcase(s, tc);
// 在test case中加入测试函数,这里是循环加入用于测试效率,如果测试正确性只需一次加入即可,如果需要多次执行也可以使用tcase_add_loop_test
for (i = 0; i < num_iters; i++)
{
tcase_add_test(tc, test_pass);
tcase_add_test(tc, test_fail);
}
// 运行测试用例
srunner_run_all(sr, CK_SILENT);
// 显示运行结果
if (srunner_ntests_failed(sr) != num_iters)
{
printf("Error: expected %d failures, got %d\n", num_iters,
srunner_ntests_failed(sr));
return;
}
srunner_free(sr);
}
int main(void)
{
int i;
time_t t1;
int iters[] = { 1, 100, 1000, 2000, 4000, 8000, 10000, 20000, 40000, -1 };
for (i = 0; iters[i] != -1; i++)
{
t1 = time(NULL);
run(iters[i]);
printf("%d, %d\n", iters[i], (int) difftime(time(NULL), t1));
}
return 0;
}
通过上面代码中的注释,对check的结构总结如下:
-
SRunner是运行的单位,通过srunner_run_all接口运行;
-
具体测试可以通过SRunner->suite->case->function四级结构通过提供的接口进行组织,当然组织工作得手动完成;
-
test function原型已经定义,需要自己去实现,这是check使用过程中的主要工作;
-
断言的使用是在几个function中比如test function、setup function和teardown function,check提供了断言的实现,并使用宏进行了封装。
check的接口定义都在check.h中,更详细的信息可以参考代码。