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

一般变量

以下变量可用于一般用途，例如配置报告、电子邮件、Parasoft DTP 或许可证设置。

为方便起见，您可以通过键入 $ 来使用 Eclipses 的内容助手，以显示可接受的变量列表，例如：

分析类型

$ 示例: ${analysis_type}

输出以逗号分隔的已启用分析类型的列表（例如：静态、生成、执行）。此变量只能用于报告和电子邮件设置。

config_name

$ 示例: ${config_name}

输出执行的测试配置的名称。此变量只能用于报告和电子邮件设置。示例：

dtp_project

示例：$dtp_project}

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

env_var

示例：${env_var:HOME}

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

general_project

示例：${general_project}

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

project_name

示例：${project_name}

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

project_loc

示例：${project_loc}

输出测试项目的位置。

有关项目位置的信息显示在项目属性的 资源 页面上。

time

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

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

tool_name

$ 示例: ${tool_name}

输出 Parasoft 产品的名称(示例：C/C++test)。

workspace_name

示例：${workspace_name}输出工作空间名称。例如， report.mail.subject=Scanner ${workspace_name} 的扫描结果 可能评估为 "MyProject 的扫描结果"。

workspace_loc

示例：${workspace_loc} 

输出工作空间的位置。

有关工作空间位置的信息显示在 Eclipse 启动器对话框的 工作空间 字段中。转到 IDE 菜单中的 文件> 切换工作空间> 其他... 以打开对话框。

resource_loc

示例：${resource_loc:<RESOURCE_PATH>} 

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

有关资源位置的信息显示在项目属性的 资源 页面上。在以下示例中，资源的项目相对路径是 /ATM/src/Account.cxx。

您可以按如下方式配置变量：${resource_loc:/ATM/src/Acount.cxx}.

构建相关变量

${CPPTEST_SCAN}

此变量会自动初始化为带有选项的 C/C++test 选项提取器实用程序；在 C/C++test 运行 Build 命令时在环境中设置。配置基于 Makefile 的项目时(项目> 属性> Parasoft>C++test> 构建选项)在构建命令行中使用。该变量可以直接在 Makefile 和构建脚本中使用以替换编译器/链接器（当 make 或构建脚本由 C/C++test 运行时）。

${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’

用在：

• 文件范围测试配置的桩函数文件位置（“使用来自其他项目文件的符号”）和自动生成的桩函数位置（“自动生成的桩函数输出位置”）。