This page documents variables that are provided by CMake or have meaning to CMake when set by project code. For general information on variables, see the Variables section in the cmake-language manual.

Jun 24, 2015 · You can use the command line to set entries in the Cache with the syntax cmake -D var:type=value, just cmake -D var=value or with cmake -C CMakeInitialCache.cmake.

Set a normal, cache, or environment variable to a given value. See the cmake-language (7) variables documentation for the scopes and interaction of normal variables and cache entries. Signatures of this command that specify a <value>... placeholder expect zero or more arguments.

Using the get_cmake_property function, the following loop will print out all CMake variables defined and their values: message(STATUS "${_variableName}=${${_variableName}}") This can also be embedded in a convenience function which can optionally use a regular expression to print only a subset of variables with matching names.

Objectives Learn about local variables. Understand that cached variables persist across runs. Know how to glob, and why you might not do it.

If you want to set a variable from the command line, CMake offers a variable cache. Some variables are already here, like CMAKE_BUILD_TYPE. The syntax for declaring a variable and setting it if it is not already set is: This will not replace an existing value.

CMake variable names are case sensitive and may only contain alphanumeric characters and underscores. A number of useful variables are automatically defined by CMake and are discussed in the cmake-variables manual. These variables begin with CMAKE_.

Sep 12, 2014 · When is the wrapping with ${...} needed and what does it mean? Why are variables often wrapped with this even if it makes no difference? Quoting the CMake documentation: A variable reference has the form ${variable_name} and is evaluated inside a Quoted Argument or an Unquoted Argument.

Dec 28, 2024 · In CMake, function creates a new scope where it is called. Variables defined in a function are private to the function and NOT defined/accessible outside of the function where it is called. However, anything defined in a macro is defined where the …

The simplicity of basic CMake variables belies the complexity of the full variable syntax. This page documents the various variable cases, with examples, and points out the pitfalls to avoid.