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

一般

• ${Workspace_loc-} 工作空间的位置。该位置显示在工作空间选择器中（要打开此位置，请选择文件> 工作空间）。

  

• ${Project_loc-}测试项目的位置。

   想要看到项目的位置，请右键单击它，选择 属性,然后打开信息 页面。该位置将在位置字段中列出。

  

• ${project_name-}测试的项目名称。

• ${resource_loc:<RESOURCE_PATH>-}指定项目资源的位置。应在任何适用的设置中引用特定的项目资源，例如，具有链接目录的项目的 make run 目录，或 VC6 项目的 .dsp 文件路径，等等。使用 resource_loc 变量来指定相对于项目的逻辑路径，因为该项目已在工作空间中注册。

  想要确定项目的路径，请右键单击它，选择 属性,然后打开信息 页面。路径对应于
  ${resource_loc:<RESOURCE_PATH>}中的<RESOURCE_PATH>变量。例如，如果路径为 /ATM_linked_src，则可以使用 ${resource_loc:/ATM_linked_src} 。对于较低级别的资源，这将相应地更改：

  

• ${env_var:<ENV_VAR_NAME>-}指定的环境变量的值。这可用于从用户环境中引用确定物理文件位置的环境变量。例如，最典型地项目位置的根目录是环境变量。
• ${<ENV_VAR_NAME>-}指定的环境变量的值。可用于所有需要磁盘位置的组件
• ${CPPTEST_SCAN-}自动初始化为带有选项的 C++test 选项提取器实用程序；在 C++test 运行 Build 命令时在环境中设置。配置基于 Makefile 的项目时(项目> 属性> Parasoft>C++test> 构建选项)在构建命令行中使用。可以直接在 Makefile 和构建脚本中使用以替换编译器/链接器（当 make 或构建脚本由 C++test 运行时）。
• ${cpptest:original_options-}  通过监视构建或读取项目文件（Visual Studio 或 MULTI）收集的原始（已测试）项目中的选项。在项目/文件属性中的编译器/链接器选项中使用。
• ${Cpptest:project_lib_files-}从 Visual Studio 项目/解决方案定义中收集的依赖库。在项目/文件属性中的编译器/链接器选项中使用。

适用于测试套件文件

仅适用于测试套件输出布局

以下变量仅在测试套件输出文件和布局 (在“测试配置”的生成> 测试 套件标签中)中使用。

• ${test_ext} - 测试套件文件(.cpp)的 C++test 特定扩展名。
• ${file_name} - 文件名。
• ${file_base_name} - 没有扩展名的文件名。
• ${File_ext}-文件扩展名。
• ${File_loc}-文件位置。
• ${file_loc_rel}-相对于项目根目录的文件位置。
• ${File_uid}- 文件唯一标识符。
• ${Function_name}-测试的函数名称。
• ${function_uid}-测试函数的唯一标识符（根据函数签名/ 错位的名称计算得出的哈希码）。

对于测试套件输出布局和导入 C++test 6.x 测试套件向导

导入 C++test 6.x 试套件向导以及 测试套件的输出文件和布局 (在测试配置的 生成> 测试套件 选项卡中)使用了以下变量。

• ${Src_file_name}- 上下文（源）文件的名称。（“上下文文件”是源文件，描述了在其中定义了给定测试函数的编译单元）。
• ${src_file_base_name} - 不带扩展名的上下文（源）文件的名称。
• ${Src_file_ext}- 上下文（源）文件的扩展名。
• ${Src_file_loc}- 上下文（源）文件位置。
• ${src_file_loc_rel}- 相对于项目根目录的上下文（源）文件位置)。
• ${Src_file_uid}- 上下文（源）文件唯一标识符（从源文件位置计算得出的哈希码）。

仅适用于导入 C++test 6.x 测试套件向导

以下变量仅在导入 C++test 6.x 测试套件向导中使用。

• ${unit_name}=导入的测试套件文件的 C++test 6.x 测试单元名称。

高级

对于临时文件

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

• 测试执行工作目录
• XML 流基础

对于配置文件

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

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

对于自动生成桩函数

${cpptest:auto-stubs} - 自动生成的桩函数文件位置。该变量指向在测试配置的自动生成的桩函数>输出位置中设置的值，如下面的屏幕截图所示。这基本上是一种快捷方式，用于同步生成桩函数和从中提取桩函数的目录。

用在：

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

对于上下文特定的桩函数

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

用在：

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