Boost C++ 库

目录

简介

设计原理

如何阅读本文档

用法变体

声明和组织测试

测试用例

无参数测试用例

数据驱动的测试用例

模板测试用例

参数化测试用例

测试树

测试套件

主测试套件

测试命名

测试树内容

装饰器

套件级装饰器

显式装饰器声明

Fixture

Fixture 模型

测试用例 Fixture

测试套件入口/出口 Fixture

全局 Fixture

管理测试依赖项

通过标签将测试分组为逻辑单元

启用或禁用测试单元执行

为测试添加语义

用于声明和组织测试的 API 摘要

编写单元测试

断言严重性级别

BOOST_TEST：通用和通用断言

报告的信息

扩展的比较支持

浮点比较

字符串和 C 字符串比较

集合比较

位比较

异常正确性

测试用例超时

预期失败规范

自定义谓词支持

输出流测试工具

BOOST_TEST: 表达式的详细信息

调试断言

用于编写测试的 API 摘要

控制输出

日志记录工具支持

记录用户定义的类型

自定义消息

用于精确定位故障的检查点

上下文

记录浮点类型数字

日志格式

测试日志输出

HRF：人类可读日志格式

XML 日志格式

JUNIT 日志格式

报告格式

人类可读报告格式

基于 XML 的报告输出格式

日志记录 API

日志输出流重定向

日志级别配置

预定义的日志格式选择

自定义日志格式支持

进度显示

用于控制输出的 API 摘要

运行时参数

测试单元过滤

自定义命令行参数

运行时参数摘要

高级用法场景

构建 Unit Test Framework

测试模块的入口点

测试模块的初始化

测试模块运行器

仅头文件变体自定义

仅头文件和多个翻译单元

自定义模块的入口点

自定义模块的初始化函数

静态库变体自定义

自定义模块的入口点

自定义模块的初始化函数

共享库变体自定义

自定义模块的入口点

自定义模块的初始化函数

外部测试运行器用法变体

废弃的初始化函数

实际使用建议

常规

IDE 使用建议

命令行使用建议

教程

使用 Boost.Test 进行测试驱动开发

为什么要使用测试框架？

网络智慧

常见问题解答

术语表

更改日志

致谢

Unit Test Framework API 参考

测试声明和组织

BOOST_TEST_CASE 和 BOOST_TEST_CASE_NAME

BOOST_AUTO_TEST_CASE

BOOST_AUTO_TEST_CASE_TEMPLATE

BOOST_TEST_CASE_TEMPLATE

BOOST_TEST_CASE_TEMPLATE_FUNCTION

BOOST_PARAM_TEST_CASE

BOOST_DATA_TEST_CASE

BOOST_DATA_TEST_CASE_F

BOOST_TEST_SUITE

BOOST_AUTO_TEST_SUITE

BOOST_AUTO_TEST_SUITE_END

BOOST_FIXTURE_TEST_CASE

BOOST_FIXTURE_TEST_SUITE

BOOST_GLOBAL_FIXTURE

BOOST_TEST_GLOBAL_FIXTURE

BOOST_TEST_DECORATOR

depends_on (decorator)

description (decorator)

enabled / disabled (decorator)

enable_if (decorator)

fixture (decorator)

label (decorator)

precondition (decorator)

用于编写测试的参考 API

BOOST_TEST

expected_failures (decorator)

timeout (decorator)

tolerance (decorator)

BOOST_<level>

BOOST_<level>_BITWISE_EQUAL

BOOST_<level>_EQUAL

BOOST_<level>_EQUAL_COLLECTIONS

BOOST_<level>_CLOSE

BOOST_<level>_CLOSE_FRACTION

BOOST_<level>_GE

BOOST_<level>_GT

BOOST_<level>_LE

BOOST_<level>_LT

BOOST_<level>_MESSAGE

BOOST_<level>_NE

BOOST_<level>_PREDICATE

BOOST_<level>_NO_THROW

BOOST_<level>_THROW

BOOST_<level>_EXCEPTION

BOOST_<level>_SMALL

BOOST_AUTO_TEST_CASE_EXPECTED_FAILURES

BOOST_ERROR

BOOST_FAIL

BOOST_IS_DEFINED

BOOST_TEST_TOOLS_UNDER_DEBUGGER

BOOST_TEST_TOOLS_DEBUGGABLE

控制测试输出

BOOST_TEST_CHECKPOINT

BOOST_TEST_PASSPOINT

BOOST_TEST_MESSAGE

BOOST_TEST_INFO

BOOST_TEST_CONTEXT

BOOST_TEST_INFO_SCOPE

BOOST_TEST_DONT_PRINT_LOG_VALUE

运行时参数参考

auto_start_dbg

build_info

catch_system_errors

color_output

detect_fp_exceptions

detect_memory_leaks

help

list_content

list_labels

log_format

log_level

log_sink

logger

output_format

random

report_format

report_level

report_memory_leaks_to

report_sink

result_code

run_test

save_pattern

show_progress

use_alt_stack

usage

wait_for_debugger

构建场景和行为

BOOST_TEST_MAIN

BOOST_TEST_MODULE

BOOST_TEST_ALTERNATIVE_INIT_API

BOOST_TEST_NO_LIB

BOOST_TEST_DYN_LINK

BOOST_TEST_NO_MAIN

BOOST_TEST_GLOBAL_CONFIGURATION

BOOST_TEST_DISABLE_ALT_STACK

参考

Header <boost/test/data/config.hpp>

Header <boost/test/data/for_each_sample.hpp>

Header <boost/test/data/monomorphic/array.hpp>

Header <boost/test/data/monomorphic/collection.hpp>

Header <boost/test/data/monomorphic/delayed.hpp>

Header <boost/test/data/monomorphic/fwd.hpp>

Header <boost/test/data/monomorphic/generate.hpp>

Header <boost/test/data/monomorphic/generators.hpp>

Header <boost/test/data/monomorphic/generators/keywords.hpp>

Header <boost/test/data/monomorphic/generators/random.hpp>

Header <boost/test/data/monomorphic/generators/xrange.hpp>

Header <boost/test/data/monomorphic/grid.hpp>

Header <boost/test/data/monomorphic/initializer_list.hpp>

Header <boost/test/data/monomorphic/join.hpp>

Header <boost/test/data/monomorphic/singleton.hpp>

Header <boost/test/data/monomorphic/zip.hpp>

Header <boost/test/data/size.hpp>

Header <boost/test/data/test_case.hpp>

Header <boost/test/debug.hpp>

Header <boost/test/debug_config.hpp>

Header <boost/test/detail/global_typedef.hpp>

Header <boost/test/execution_monitor.hpp>

Header <boost/test/framework.hpp>

Header <boost/test/output/compiler_log_formatter.hpp>

Header <boost/test/output/plain_report_formatter.hpp>

Header <boost/test/output/xml_log_formatter.hpp>

Header <boost/test/output/xml_report_formatter.hpp>

Header <boost/test/parameterized_test.hpp>

Header <boost/test/progress_monitor.hpp>

Header <boost/test/results_collector.hpp>

Header <boost/test/results_reporter.hpp>

Header <boost/test/tools/assertion_result.hpp>

Header <boost/test/tools/detail/bitwise_manip.hpp>

Header <boost/test/tools/detail/lexicographic_manip.hpp>

Header <boost/test/tools/detail/per_element_manip.hpp>

Header <boost/test/tools/detail/tolerance_manip.hpp>

Header <boost/test/tools/floating_point_comparison.hpp>

Header <boost/test/tools/output_test_stream.hpp>

Header <boost/test/tree/observer.hpp>

Header <boost/test/tree/test_unit.hpp>

Header <boost/test/unit_test.hpp>

Header <boost/test/unit_test_log.hpp>

Header <boost/test/unit_test_log_formatter.hpp>

Header <boost/test/unit_test_parameters.hpp>

Header <boost/test/utils/algorithm.hpp>

Header <boost/test/utils/is_forward_iterable.hpp>

Header <boost/test/utils/named_params.hpp>