C++ 单元测试 Cpputest

时间:2023-11-10 23:59:32

参见: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信息