修改环境¶
添加于版本 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
值会导致测试在执行前失败。这样做是为了在不改变现有测试的有效行为的情况下添加未来操作。
此属性带来的环境变化不会影响其他测试。