summaryrefslogtreecommitdiffstats
path: root/Help/variable/CACHE.rst
blob: 230739acc8e25fb7211eeb1f690e8fc27c4cfc8c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
CACHE
-----

Read cache variables.

Use the syntax ``$CACHE{VAR}`` to read cache entry ``VAR``.
See the :ref:`cmake-language(7) variables <CMake Language Variables>`
documentation for more complete documentation of the interaction of
normal variables and cache entries.

When evaluating :ref:`Variable References` of the form ``${VAR}``,
CMake first searches for a normal variable with that name, and if not
found CMake will search for a cache entry with that name.
The ``$CACHE{VAR}`` syntax can be used to do direct cache lookup and
ignore any existing normal variable.

See the :command:`set` command to see how to write cache variables.