参见:http://cpputest.github.io/
1. CppUTest是一个C/C++单元测试框架,可以在C/C++项目中使命。
2. 第一个测试
新建一个cpp 文件,包含一个TEST_GROUP 和一个 TEST。下面的例子表明测试结果是失败。
#include "CppUTest/TestHarness.h"
int main(int ac, char** av)
{
//运行所有的单元测试
return CommandLineTestRunner::RunAllTests(ac, av);
} TEST_GROUP(FirstTestGroup)
{
}; TEST(FirstTestGroup, FirstTest)
{
FAIL("Fail me!");
} TEST(FirstTestGroup, SecondTest)
{//向FirstTestGroup中再增加一个测试
STRCMP_EQUAL("hello", "world");
LONGS_EQUAL(, );
CHECK(false);
}
3. 常用宏
- TEST(group, name) - 定义一个测试
- IGNORE_TEST(group, name) - 关闭一个测试
- TEST_GROUP(group) - 声明一个测试组,测试组将包含多个测试
- TEST_GROUP_BASE(group, base) - 和TEST_GROUP类似,不同的是它用了其它的基类,而非Utest
- IMPORT_TEST_GROUP(group) - 导出一个测试组的名字,使得它可以从一个库中被访问到
4. setup and teardown
每个test组可以有一个setup和一个teardown方法。setup是开始测试开始前调用,用于初始化一些资源。teardown在结束时调用。
TEST_GROUP(FooTestGroup)
{
void setup()
{
// Init stuff
} void teardown()
{
// Uninit stuff
}
};
5. 断言
- CHECK
- CHECK(boolean condition) - 判断bool条件
- CHECK_TEXT(boolean condition, text) - 判断bool条件,并打印text里的消息
- CHECK_FALSE(condition) - 判断bool条件
- CHECK_FALSE_TEXT(condition, text) - 判断bool条件,并打印text里的消息
- CHECK_EQUAL(expected, actual) - 判断两个对象的值是否相同
- CHECK_THROWS(expected_exception, expression) - 判断 expression 是否抛出异常 expected_exception
- 字符串相关
- STRCMP_EQUAL(expected, actual) - 用strcmp()判断两个字符串常量是否相同
- STRNCMP_EQUAL(expected, actual, length) - 用strncmp()判断两个字符串常量是否相同
- STRCMP_NOCASE_EQUAL(expected, actual) - 用strcmp()判断两个字符串常量是否相同,且不考虑大小写
- STRCMP_CONTAINS(expected, actual) - 判断 actual 是否包含 expected.
- 两个对象比较
- LONGS_EQUAL(expected, actual) - 比较两个数值
- UNSIGNED_LONGS_EQUAL(expected, actual) - 比较两个非负数
- BYTES_EQUAL(expected, actual) - 比较两个8个位长的数
- POINTERS_EQUAL(expected, actual) - 比较两个指针
- DOUBLES_EQUAL(expected, actual, tolerance) - 比较两个double数值,容忍度是tolerance范围内
- FUNCTIONPOINTERS_EQUAL_TEXT(expected, actual, text) - 比较两个函数指针
- MEMCMP_EQUAL(expected, actual, size) - 比较两块内存
- BITS_EQUAL(expected, actual, mask) - 比较两个数和mask计算后的结果
- FAIL(text) - 总是失败,并打印text信息