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
值将导致测试在执行前失败。这样做是为了将来可以添加操作,而不会改变现有测试的有效行为。
此属性引起的环境更改不会影响其他测试。