本主题定义了可在 C/C++test 中使用的变量。

常规变量

以下变量可用于常规目的，例如，配置报告、e-mail、Parasoft DTP 或许可证设置。 会话标签值不得包含任何 ':' 字符。

analysis_type

$ 示例：${analysis_type}

输出一个逗号分隔的已启用分析类型列表（例如: Static, Generation, Execution）。此变量只能在报告和 e-mail 设置中使用。

config_name

$ 示例：${config_name}

输出执行测试项目的名称。此变量只能在报告和 e-mail 设置中使用。例如：

dtp_project

示例： $dtp_project}

输出与被测项目相对应的项目 DTP 的名称。

env_var

示例： ${env_var:HOME}

输出冒号后指定的环境变量的值。

general_project

示例： ${general_project}

输出结果链接到的 DTP 常规项目的名称。

project_name

示例： ${project_name}

输出测试项目名称。如果提供了多个项目作为输入，它首先输出被测项目名称，然后输出 "..."。

project_loc

示例： ${project_loc}

输出被测项目位置。

solution_name

示例： ${solution_name}

输出被测 Visual Studio 解决方案的名称。如果提供了多个解决方案作为输入，它首先输出被测解决方案名称，然后输出 "..."。

solution_loc

示例： ${solution_loc}

输出被测 Visual Studio 解决方案的位置。

time

示例：${time:yyyy-MM-dd-HH.mm}

输出当前时间。默认为 yyyy-MM-dd。您可以自定义格式（如以上示例所示）。

tool_name

$ 示例：${tool_name}

输出 Parasoft 产品的名称（例如：C/C++test）。

workspace_name

示例： ${workspace_name}输出 Visual Studio 解决方案名称。例如，report.mail.subject=Scanner Results for ${workspace_name} 可能解析为“Scanner Results for solutionAccoun1.sln”。

resource_loc

示例： ${resource_loc:<RESOURCE_PATH>} 

输出指定项目资源的位置。此变量可用于引用任何适用设置中的项目资源，如具有链接目录的项目的 make 运行目录或 VC6 项目的 .dsp 文件路径等。指定项目在工作空间中注册时相对于项目的逻辑路径。

构建相关变量

${CPPTEST_SCAN}

该变量自动初始化为带选项的 C/C++test 选项提取器工具；在 C/C++test 运行 Build 命令时的环境中设置。配置基于 Makefile 的项目（项目> 属性> Parasoft> C++test> 构建设置）时在 Build 命令行中使用。该变量可以直接在 Makefile 和 build 脚本中使用，以取代编译器/链接器（当 C/C++test 运行 make 或 build 脚本时）。

${cpptest:original_options}

从监控构建或读取项目文件（Visual Studio 或 MULTI）中收集的原始（被测）项目的选项。用于项目/文件属性中的编译器/链接器选项。

${cpptest:project_lib_files}

从 Visual Studio 项目/解决方案定义中收集的依赖库。用于项目/文件属性中的编译器/链接器选项。

测试套件文件的变量

您可以使用以下变量来配置测试配置中生成> 测试套件选项卡的测试套件输出文件和布局选项：

• ${test_ext} - 测试套件文件（.cpp）的 C/C++test 专用扩展名。
• ${file_name} - 文件名。
• ${file_base_name} - 不带扩展名的文件名。
• ${file_ext} - 文件扩展名。
• ${file_loc} - 文件位置。
• ${file_loc_rel} - 相对于项目根目录的文件位置。
• ${file_uid} - 文件唯一标识符。
• ${function_name} - 被测函数的名称。
• ${function_uid} - 被测函数的唯一标识符（根据函数签名/修饰名称计算的哈希码）。

其他变量

临时文件

${cpptest:testware_loc} - C/C++test 临时文件位置。用于：

• 测试执行工作目录
• 流程配置 XML

配置文件

${cpptest:cfg_dir} - C/C++test 配置文件位置。用于：

• 流程配置 XML
• 桩函数文件位置
• 项目/文件属性中的编译器/链接器选项

自动生成的桩函数

${cpptest:auto-stubs} - 自动生成的桩函数文件的位置。此变量指向测试配置中自动生成的桩函数> 输出位置设置的值，如下图所示。这基本上是一个快捷方式，可以同步生成桩函数的目录和获取桩函数的目录。

用于：

• 桩函数文件位置 - 仅适用于生成桩函数的测试配置。

上下文专用桩函数

• ${ctx_name} - 被测上下文文件的名称；例如，'foo.cpp'
• ${ctx_base_name} - 被测上下文文件的基本名；例如，'foo'
• ${ctx_ext} - 被测上下文文件的扩展名；例如，'cpp'
• ${ctx_loc_rel} - 被测上下文文件的项目相关位置；例如，'src/subdir'

用于：

• File Scope 测试配置的桩函数文件位置（'使用来自附加的项目文件的符号'）和自动生成的桩函数的位置（'自动生成的桩函数的输出位置'）。