Kitware/CMake
1
0
Fork 0
mirror of https://github.com/Kitware/CMake.git synced 2025-10-14 02:08:27 +08:00
Code Issues Projects Releases Wiki Activity

Help:ENV: note escaping needed for special characters

Browse Source
This commit is contained in:
scivision
2023-08-17 09:57:57 -04:00
committed by Brad King
parent 4653f80260
commit a8634b878a
1 changed files with 11 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

11
Help/variable/ENV.rst
View File

@@ -8,6 +8,17 @@ Use the syntax ``$ENV{VAR}`` to read environment variable ``VAR``.
To test whether an environment variable is defined, use the signature
``if(DEFINED ENV{<name>})`` of the :command:`if` command.
.. note::
Environment variable names containing special characters like parentheses
may need to be escaped. (Policy :policy:`CMP0053` must also be enabled.)
For example, to get the value of the Windows environment variable
``ProgramFiles(x86)``, use:
.. code-block:: cmake
set(ProgramFiles_x86 "$ENV{ProgramFiles\(x86\)}")
For general information on environment variables, see the
:ref:`Environment Variables <CMake Language Environment Variables>`
section in the :manual:`cmake-language(7)` manual.