mirror of
https://gitlab.kitware.com/cmake/cmake.git
synced 2026-10-02 04:02:23 +03:00
Help:ENV: note escaping needed for special characters
This commit is contained in:
1 parent
4653f80260
commit
a8634b878a
1 file changed
+11
@@ -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.
|
||||
Reference in new issue
Block a user