本主题定义了可以在 C/C++test 中使用的变量。
一般变量
以下变量可用于一般用途,例如配置报告、电子邮件、Parasoft DTP 或许可证设置。 会话标签值不得包含任何 ':’ 字符。
分析类型
$ 示例: ${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 项目/解决方案定义收集的依赖库。在项目/文件属性中的编译器/链接器选项中使用。
测试套件文件的变量
您可以使用以下变量在测试配置的 生成> 测试套件选项卡中配置 测试套件输出文件和布局 选项:
- ${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’
用在:
- 文件范围测试配置的桩函数文件位置(“使用来自其他项目文件的符号”)和自动生成的桩函数位置(“自动生成的桩函数输出位置”)。