本主题定义了可在 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 测试配置的桩函数文件位置（'使用来自附加的项目文件的符号'）和自动生成的桩函数的位置（'自动生成的桩函数的输出位置'）。
