1CACHE
2-----
3
4.. versionadded:: 3.13
5
6Operator to read cache variables.
7
8Use the syntax ``$CACHE{VAR}`` to read cache entry ``VAR``.
9See the :ref:`cmake-language(7) variables <CMake Language Variables>`
10documentation for more complete documentation of the interaction of
11normal variables and cache entries.
12
13When evaluating :ref:`Variable References` of the form ``${VAR}``,
14CMake first searches for a normal variable with that name, and if not
15found CMake will search for a cache entry with that name.
16The ``$CACHE{VAR}`` syntax can be used to do direct cache lookup and
17ignore any existing normal variable.
18
19See the :command:`set` and :command:`unset` commands to see how to
20write or remove cache variables.
21