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 值将导致测试在执行之前失败。这是为了在不更改现有测试的有效行为的情况下添加未来的操作。

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