ENVIRONMENT_MODIFICATION

3.22 版本新增。

指定运行测试时应修改的环境变量。请注意,此属性执行的操作在 ENVIRONMENT 属性已应用之后执行。

设置为由分号分隔的环境变量和值列表,形式为 MYVAR=OP:VALUE,其中 MYVAR 是要修改的环境变量的区分大小写的名称。条目按属性值中指定的顺序考虑。OP 可以是以下之一:

  • reset:重置为未修改的值,忽略在此条目之前对 MYVAR 的所有修改。请注意,如果设置了变量,这将把变量重置为由 ENVIRONMENT 设置的值,否则重置为 CTest 执行其余部分的其状态。

  • set:将 MYVAR 的当前值替换为 VALUE

  • unset:取消设置 MYVAR 的当前值。

  • string_append:使用单个 VALUE 将其附加到 MYVAR 的当前值。

  • string_prepend:使用单个 VALUE 将其前置到 MYVAR 的当前值。

  • path_list_append:使用主机平台的路径列表分隔符(Windows 上为 ;,其他地方为 :)将单个 VALUE 附加到 MYVAR 的当前值。

  • path_list_prepend:使用主机平台的路径列表分隔符(Windows 上为 ;,其他地方为 :)将单个 VALUE 前置到 MYVAR 的当前值。

  • cmake_list_append:使用 ; 作为分隔符将单个 VALUE 附加到 MYVAR 的当前值。

  • cmake_list_prepend:使用 ; 作为分隔符将单个 VALUE 前置到 MYVAR 的当前值。

无法识别的 OP 值将导致测试在执行前失败。这样做是为了将来可以添加操作,而不会改变现有测试的有效行为。

此属性引起的环境更改不会影响其他测试。