修改环境

添加于版本 3.22。

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

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

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

  • set:用 VALUE 替换 MYVAR 的当前值。

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

此属性带来的环境变化不会影响其他测试。