本主题定义可以在 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'
用在:
- 文件范围测试配置的桩函数文件位置(“使用来自其他项目文件的符号”)和自动生成的桩函数位置(“自动生成的桩函数输出位置”)。