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

一般变量

以下变量可用于一般用途,例如配置报告、电子邮件、Parasoft DTP 或许可证设置。(warning) 会话标签值不得包含任何 ':’ 字符。

分析类型

$ 示例: ${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}

输出测试项目的位置。

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 结果可以评估为“solutionAccoun1.sln 的 Scanner 结果”。

resource_loc

示例:${resource_loc:<RESOURCE_PATH>} 

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

构建相关变量

${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 项目/解决方案定义收集的依赖库。在项目/文件属性中的编译器/链接器选项中使用。

测试套件文件的变量

  • file = 定义测试函数的源/头文件。
  • source file = 定义用于定义测试函数的编译单元的源文件。

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

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

用在:

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