blob: 61ba5b80f35197cefaecddba7763aaf427ac0d64 [file] [log] [blame]
Ryan Prichardf6283ab2022-01-13 17:30:19 -08001CXX
2---
3
4.. include:: ENV_VAR.txt
5
6Preferred executable for compiling ``CXX`` language files. Will only be used by
7CMake on the first configuration to determine ``CXX`` compiler, after which the
8value for ``CXX`` is stored in the cache as
9:variable:`CMAKE_CXX_COMPILER <CMAKE_<LANG>_COMPILER>`. For any configuration
10run (including the first), the environment variable will be ignored if the
11:variable:`CMAKE_CXX_COMPILER <CMAKE_<LANG>_COMPILER>` variable is defined.
12
13.. note::
14 Options that are required to make the compiler work correctly can be included;
15 they can not be changed.
16
17.. code-block:: console
18
19 $ export CXX="custom-compiler --arg1 --arg2"