环境修改

在 3.22 版本加入.

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

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

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

  • set：将``MYVAR`` 的当前值替换为``VALUE``。

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

  • string_append：将单数``VALUE`` 附加到``MYVAR`` 的当前值。

  • string_prepend：在``MYVAR`` 的当前值前加上单数``VALUE``。

  • path_list_append：使用主机平台的路径列表分隔符（Windows 上的``;`` 和其他地方的``:）将单数``VALUE 附加到``MYVAR`` 的当前值。

  • path_list_prepend：使用主机平台的路径列表分隔符（Windows 上的``;`` 和其他地方的``:）将单数``VALUE 添加到``MYVAR`` 的当前值。

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

  • cmake_list_prepend：使用``;``作为分隔符将单数``VALUE``添加到``MYVAR``的当前值。

无法识别的 OP 值将导致测试在执行之前失败。这样可以在不改变现有测试的有效行为的情况下添加未来的操作。

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