unset

取消設定變數、快取變數或環境變數。

Unset Normal Variable

unset(<variable> [PARENT_SCOPE])

Removes a normal variable from the current scope, causing it to become undefined.

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.

備註

When evaluating 變數參照 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.

Unset Cache Entry

unset(CACHE{<variable>})

在 4.2 版被加入.

Removes <variable> from the cache, causing it to become undefined.

unset(<variable> CACHE)

This signature is supported for compatibility purpose. Use preferably the other one.

取消設定環境變數

unset(ENV{<variable>})

Removes <variable> from the currently available Environment Variables. Subsequent calls of $ENV{<variable>} will return the empty string.

This command affects only the current CMake process, not the process from which CMake was called, nor the system environment at large, nor the environment of subsequent build or test processes.

另請參見