访问测试用例

自动生成的测试用例保存在测试套件文件中。使用默认设置，C++test 为每个测试文件生成一个测试套件。它还可以被配置为为每个功能生成一个测试套件（有关详细信息，请查阅测试套件选项卡）。

要查看生成的测试用例：

在项目树中，找到 C++test 生成的测试套件文件。
- 默认情况下，自动生成的测试类保存在所测试项目的 tests/autogenerated 目录中。
- 要检查或修改 C++test 测试套件文件保存的位置，请打开【测试配置】对话框，选择用于生成测试的测试运行的【测试配置】，然后查看 生成> 测试套件 选项卡的 测试套件输出文件和布局 字段（有关详细信息请查阅测试套件选项卡）。
双击表示生成的测试类的项目树节点。生成的测试类文件将在编辑器中打开。

了解测试用例

测试套件包含使用以下架构的测试用例：

测试套件 是一种用于测试用例的框架。它有助于对测试用例进行分组。每个测试套件都有一个类定义，该类定义派生自 CppTest_TestSuite 类，测试用例声明和测试用例函数的定义。
- 为 C++ 函数或类方法生成的测试套件采用类的形式，并且测试用例是该类的公共方法。如果被测方法是类成员，那么测试套件类就成为被测试方法所在的类的朋友。这种关联非常强大，因为它提供了从测试用例内部控制测试类的私有成员的能力。
- C 代码的测试套件仅用作声明全局函数的容器(文件)。
测试用例 是测试套件类的公共方法或全局函数（取决于它是为 C 还是 C++ 生成的），它包含三个部分：
- Arguments/Pre 条件分配：
- 经过测试的函数调用。
- Results/Post 条件验证。C++test 定义了一组用于控制和验证结果的宏。这些宏可用于将消息/断言从测试可执行文件传递到 C++test GUI。可用的宏在 C/C++test API 文档位置列出。

如果稍后将更多的功能添加到待测试文件中，那么测试生成将在更新后的文件上运行，额外的测试用例将添加到原始的测试套件文件中。

上下文和包含宏

每个测试套件都以以下两个宏开始：

CPPTEST_CONTEXT: 指定测试套件测试哪个文件。只能指定一个源文件。如果未指定上下文，则在执行项目时将执行测试套件。
- 在开始执行测试之前，在项目树中选择了源文件或目录时，C++test 会扫描【测试配置】的测试搜索路径中指定的所有测试目录。所有匹配所选上下文的测试套件都将被执行。
- 如果选择了整个项目，则将执行测试路径上的所有测试套件。
- 如果选择了一个测试套件或单个测试，则使用 CONTEXT 宏回溯到与此测试套件相关的源文件。仅执行所选的测试套件。
CPPTEST_TEST_SUITE_INCLUDED_TO: 表示它是包含的测试套件，并指定在生成测试可执行文件时将包含测试套件源的文件。如果要包括其他文件，请使用 #include 指令。

这两个宏指定的文件应始终与被测文件的名称匹配。如果待测试文件的名称更改，则必须相应地修改这些宏的值。

这两个宏都可以使用相对路径。相对路径必须以“ ./”或“ ../”开头。

后置条件宏

以下后置条件宏用于报告测试执行期间变量或类成员所具有的值：

CPPTEST_POST_CONDITION_BOOL(value_string, value)
CPPTEST_POST_CONDITION_INTEGER(value_string, value)
CPPTEST_POST_CONDITION_UINTEGER(value_string, value)
CPPTEST_POST_CONDITION_FLOAT(value_string, value)
CPPTEST_POST_CONDITION_CSTR(value_string, value)
CPPTEST_POST_CONDITION_CSTR_N(value_string, value, max_size)
CPPTEST_POST_CONDITION_MEM_BUFFER(value_string, value, size)
CPPTEST_POST_CONDITION_PTR(value_string, value)

这些宏的结果（报告的所有断言值）都显示在【质量任务】视图中。任何带有报告后置条件的测试用例都可以在回归测试中自动验证。验证将后置条件宏更改为断言，如果后续测试没有生成预期的(经过验证的)值，则断言将失败。这对于自动生成遗留代码的回归基础特别有用。有关验证的详细信息，请查阅验证测试用例以进行回归测试。

其他宏

验证后置条件时，将断言宏添加到测试用例。

此外，可以根据您的测试需求手动添加其他宏。

有关可以在测试用例中使用的宏的列表，请查阅 C/C++test API 文档。

测试功能

自动生成的测试用例有时包含特殊功能（例如，用于访问最大值的最小值）。

为了使用不同的数值生成测试用例，C++test 运行时库包含一组函数，这些函数返回整数和浮点类型的最小/最大值。下表描述了这些函数。所有列出的功能都可以在用户定义的测试用例中使用。

功能	目的
`char cpptestLimitsGetMaxChar(void);`	返回 char 类型的最大值。
`char cpptestLimitsGetMinChar(void);`	返回 char 类型的最小值。
`signed char cpptestLimitsGetMaxSigned Char(void);`	返回 char 类型的最小值。
`signed char cpptestLimitsGetMinSigned Char(void);`	返回带符号 char 类型的最小值。
`unsigned char cpptestLimitsGetMaxUnsigned Char(void);`	返回不带符号 char 类型的最大值。
`short cpptestLimitsGetMaxShort(void);`	返回 short 类型的最大值。
`short cpptestLimitsGetMinShort(void);`	返回 short 类型的最小值。
`unsigned short cpptestLimitsGetMax UnsignedShort(void);`	返回不带符号 short 类型的最大值。
`int cpptestLimitsGetMaxInt(void);`	返回 int 类型的最大值。
`int cpptestLimitsGetMinInt(void);`	返回 int 类型的最小值。
`unsigned int cpptestLimitsGetMaxUnsigned Int(void);`	返回不带符号 int 类型的最大值。
`long cpptestLimitsGetMaxLong(void);`	返回 long 类型的最大值。
`long cpptestLimitsGetMinLong(void);`	返回 long 类型的最小值。
`unsigned long cpptestLimitsGetMaxUnsigned Long(void);`	返回不带符号 long 类型的最大值。
`float cpptestLimitsGetMaxPosFloat(void);`	返回 float 类型的最大值。
`float cpptestLimitsGetMinNegFloat(void);`	返回 float 类型的最小值。
`float cpptestLimitsGetMaxNegFloat(void);`	返回 float 类型的最大负值。
`float cpptestLimitsGetMinPosFloat(void);`	返回 float 类型的最小正值。
`double cpptestLimitsGetMaxPosDouble(void);`	返回 double 类型的最大正值。
`double cpptestLimitsGetMinNegDouble(void);`	返回 double 类型的最小负值。
`double cpptestLimitsGetMaxNegDouble(void);`	返回 double 类型的最大负值。
`double cpptestLimitsGetMinPosDouble(void);`	返回 double 类型的最小正值。
`long double cpptestLimitsGetMaxPosLong Double(void);`	返回 long double 类型的最大正值。
`long double cpptestLimitsGetMinNegLong Double(void);`	返回 long double 类型的最小负值。
`long double cpptestLimitsGetMaxNegLong Double(void);`	返回 long double 类型的最大负值。
`long double cpptestLimitsGetMinPosLongDou-ble(void);`	返回 long double 类型的最大正值。

了解自动生成的存根

请查阅了解和自定义自动生成的存根。