1CUDAHOSTCXX
2-----------
3
4.. versionadded:: 3.8
5
6.. include:: ENV_VAR.txt
7
8Preferred executable for compiling host code when compiling ``CUDA``
9language files. Will only be used by CMake on the first configuration to
10determine ``CUDA`` host compiler, after which the value for ``CUDAHOSTCXX`` is
11stored in the cache as :variable:`CMAKE_CUDA_HOST_COMPILER`. For any
12configuration run (including the first), the environment variable will be
13ignored if the :variable:`CMAKE_CUDA_HOST_COMPILER` variable is defined.
14
15This environment variable is primarily meant for use with projects that
16enable ``CUDA`` as a first-class language.
17
18.. note::
19
20  Ignored when using :ref:`Visual Studio Generators`.
21
22.. versionadded:: 3.13
23  The :module:`FindCUDA`
24  module will use this variable to initialize its ``CUDA_HOST_COMPILER`` setting.
25