Boost C++ 库

目录

引言

设计原理

如何阅读本文档

使用方法

声明和组织测试

测试用例

无参数的测试用例

数据驱动的测试用例

模板测试用例

参数化测试用例

测试树

测试套件

主测试套件

测试命名

测试树内容

装饰器

套件级装饰器

显式装饰器声明

夹具

夹具模型

测试用例夹具

测试套件入口/出口夹具

全局夹具

管理测试依赖关系

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

启用或禁用测试单元执行

为测试添加语义

声明和组织测试的 API 摘要

编写单元测试

断言严重性级别

BOOST_TEST：通用断言

报告信息

扩展比较支持

浮点数比较

字符串和 C 字符串比较

集合比较

按位比较

异常正确性

测试用例超时

预期失败规范

自定义谓词支持

输出流测试工具

BOOST_TEST：表达式详情

调试断言

编写测试的 API 摘要

控制输出

日志记录工具支持

记录用户定义类型

自定义消息

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

上下文

记录浮点数

日志格式

测试日志输出

HRF：人类可读日志格式

XML 日志格式

JUNIT 日志格式

报告格式

人类可读报告格式

基于 XML 的报告输出格式

日志记录 API

日志输出流重定向

日志级别配置

预定义日志格式选择

自定义日志格式支持

进度显示

控制输出的 API 摘要

运行时参数

测试单元过滤

自定义命令行参数

运行时参数摘要

高级用法场景

构建单元测试框架

测试模块的入口点

测试模块的初始化

测试模块运行器

仅限头文件的变体定制

具有多个翻译单元的仅限头文件

自定义模块入口点

自定义模块初始化函数

静态库变体定制

自定义模块入口点

自定义模块初始化函数

共享库变体定制

自定义模块入口点

自定义模块初始化函数

外部测试运行器使用方法

已废弃的初始化函数

实用使用方法建议

常规

IDE 使用建议

命令行使用建议

教程

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

测试框架，有什么用？

网络资源

常见问题

词汇表

变更日志

致谢

单元测试框架 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 (装饰器)

description (装饰器)

enabled / disabled (装饰器)

enable_if (装饰器)

fixture (装饰器)

label (装饰器)

precondition (装饰器)

编写测试的参考 API

BOOST_TEST

expected_failures (装饰器)

timeout (装饰器)

tolerance (装饰器)

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

参考

头文件 <boost/test/data/config.hpp>

头文件 <boost/test/data/for_each_sample.hpp>

头文件 <boost/test/data/monomorphic/array.hpp>

头文件 <boost/test/data/monomorphic/collection.hpp>

头文件 <boost/test/data/monomorphic/delayed.hpp>

头文件 <boost/test/data/monomorphic/fwd.hpp>

头文件 <boost/test/data/monomorphic/generate.hpp>

头文件 <boost/test/data/monomorphic/generators.hpp>

头文件 <boost/test/data/monomorphic/generators/keywords.hpp>

头文件 <boost/test/data/monomorphic/generators/random.hpp>

头文件 <boost/test/data/monomorphic/generators/xrange.hpp>

头文件 <boost/test/data/monomorphic/grid.hpp>

头文件 <boost/test/data/monomorphic/initializer_list.hpp>

头文件 <boost/test/data/monomorphic/join.hpp>

头文件 <boost/test/data/monomorphic/singleton.hpp>

头文件 <boost/test/data/monomorphic/zip.hpp>

头文件 <boost/test/data/size.hpp>

头文件 <boost/test/data/test_case.hpp>

头文件 <boost/test/debug.hpp>

头文件 <boost/test/debug_config.hpp>

头文件 <boost/test/detail/global_typedef.hpp>

头文件 <boost/test/execution_monitor.hpp>

头文件 <boost/test/framework.hpp>

头文件 <boost/test/output/compiler_log_formatter.hpp>

头文件 <boost/test/output/plain_report_formatter.hpp>

头文件 <boost/test/output/xml_log_formatter.hpp>

头文件 <boost/test/output/xml_report_formatter.hpp>

头文件 <boost/test/parameterized_test.hpp>

头文件 <boost/test/progress_monitor.hpp>

头文件 <boost/test/results_collector.hpp>

头文件 <boost/test/results_reporter.hpp>

头文件 <boost/test/tools/assertion_result.hpp>

头文件 <boost/test/tools/detail/bitwise_manip.hpp>

头文件 <boost/test/tools/detail/lexicographic_manip.hpp>

头文件 <boost/test/tools/detail/per_element_manip.hpp>

头文件 <boost/test/tools/detail/tolerance_manip.hpp>

头文件 <boost/test/tools/floating_point_comparison.hpp>

头文件 <boost/test/tools/output_test_stream.hpp>

头文件 <boost/test/tree/observer.hpp>

头文件 <boost/test/tree/test_unit.hpp>

头文件 <boost/test/unit_test.hpp>

头文件 <boost/test/unit_test_log.hpp>

头文件 <boost/test/unit_test_log_formatter.hpp>

头文件 <boost/test/unit_test_parameters.hpp>

头文件 <boost/test/utils/algorithm.hpp>

头文件 <boost/test/utils/is_forward_iterable.hpp>

头文件 <boost/test/utils/named_params.hpp>