ENVIRONMENT_MODIFICATIONΒΆ
New in version 3.22.
Specify environment variables that should be modified for running a test. Note
that the operations performed by this property are performed after the
ENVIRONMENT
property is already applied.
If set to a list of environment variables and values of the form
MYVAR=OP:VALUE
, where MYVAR
is the case-sensitive name of an
environment variable to be modified. Entries are considered in the
order specified in the property's value. The OP
may be one of:
reset
: Reset to the unmodified value, ignoring all modifications toMYVAR
prior to this entry. Note that this will reset the variable to the value set byENVIRONMENT
, if it was set, and otherwise to its state from the rest of the CTest execution.
set
: Replaces the current value ofMYVAR
withVALUE
.
unset
: Unsets the current value ofMYVAR
.
string_append
: AppendsVALUE
to the current value ofMYVAR
.
string_prepend
: PrependsVALUE
to the current value ofMYVAR
.
path_list_append
: AppendsVALUE
to the current value ofMYVAR
using the host platform's path list separator (;
on Windows and:
elsewhere).
path_list_prepend
: PrependsVALUE
to the current value ofMYVAR
using the host platform's path list separator (;
on Windows and:
elsewhere).
cmake_list_append
: AppendsVALUE
to the current value ofMYVAR
using;
as the separator.
cmake_list_prepend
: PrependsVALUE
to the current value ofMYVAR
using;
as the separator.
Unrecognized OP
values will result in the test failing before it is
executed. This is so that future operations may be added without changing
valid behavior of existing tests.
The environment changes from this property do not affect other tests.