On this page
unset
Unset a variable, cache variable, or environment variable.
unset(<variable> [CACHE | PARENT_SCOPE])
Removes a normal variable from the current scope, causing it to become undefined. If CACHE
is present, then a cache variable is removed instead of a normal variable. Note that when evaluating Variable References of the form ${VAR}
, CMake first searches for a normal variable with that name. If no such normal variable exists, CMake will then search for a cache entry with that name. Because of this unsetting a normal variable can expose a cache variable that was previously hidden. To force a variable reference of the form ${VAR}
to return an empty string, use set(<variable> "")
, which clears the normal variable but leaves it defined.
If PARENT_SCOPE
is present then the variable is removed from the scope above the current scope. See the same option in the set()
command for further details.
<variable>
can be an environment variable such as:
unset(ENV{LD_LIBRARY_PATH})
in which case the variable will be removed from the current environment.
© 2000–2019 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/v3.13/command/unset.html