(二)cmockery中run_tests.c分析
所分析的run_tests.c文件位于 工程中的 cmockery/src/example/ 目录下,仅仅只有十几行代码,不过可以通过这十几行代码的分析达到管中窥豹的效果;
run_tests.c:
#include <stdarg.h>
#include <stddef.h>
#include <setjmp.h>
#include <cmockery.h>
// A test case that does nothing and succeeds.
void null_test_success(void **state) {
}
int main(int argc, char* argv[]) {
const UnitTest tests[] = {
unit_test(null_test_success),
};
return run_tests(tests);
}
对于代码中出现的几个部件进行分解开来看,如下:
UnitTest结构体:
// 函数原型用于setup, test and teardown functions.
typedef void (*UnitTestFunction)(void **state);
// 单元测试函数的类型
typedef enum UnitTestFunctionType {
UNIT_TEST_FUNCTION_TYPE_TEST = 0,
UNIT_TEST_FUNCTION_TYPE_SETUP,
UNIT_TEST_FUNCTION_TYPE_TEARDOWN,
} UnitTestFunctionType;
/*
* 存储一个单元测试函数包括其函数名和类型
* 注意:每设置一个函数必须有一个teardown函数对应,可以指定一个NULL函数指针
*/
typedef struct UnitTest {
const char* name;
UnitTestFunction function;
UnitTestFunctionType function_type;
} UnitTest;
可以看到这个结构体中所包含的内容只有一个函数名,一个函数指针,一个函数的类型枚举;
unit_test:是一个宏体,定义如下:
// 初始化一个单元测试结构体.
#define unit_test(f) { #f, f, UNIT_TEST_FUNCTION_TYPE_TEST }
所有上面main.c中的代码行:unit_test(null_test_success),按照宏定义进行展开后表示如下:
{"null_test_success", null_test_success, UNIT_TEST_FUNCTION_TYPE_TEST},
所以正好填充了结构体数组的第一个元素的各个值;
run_tests:是一个宏体,定义如下:
/*
* 运行通过UnitTest结构体数组指定的测试,下面的样例
* 以unit_test宏来描述了这个宏的用法
*
* void Test0();
* void Test1();
*
* int main(int argc, char* argv[]) {
* const UnitTest tests[] = {
* unit_test(Test0);
* unit_test(Test1);
* };
* return run_tests(tests);
* }
*/
run_tests(tests) _run_tests(tests, sizeof(tests) / sizeof(tests)[0])
将代码中run_tests(tests);展开之后内容为:_run_tests(tests, 1);
先简要介绍该函数的功能:
在_run_tests函数中根据tests中元素的赋值情况,即类型和函数指针,进行不同的分支并调用_run_test运行该元素的函数指针所指向的函数体。并将运行的结果进行返回。
在这个过程中还会将函数执行的状态进行记录,其中包括了链表,内存分配,信号等相关的操作。后续会进行这个功能详细的分析。