Help/prop_tgt/CUDA_STANDARD.rst

   1 CUDA_STANDARD
   2 -------------
   3
   4 .. versionadded:: 3.8
   5
   6 The CUDA/C++ standard whose features are requested to build this target.
   7
   8 This property specifies the CUDA/C++ standard whose features are requested
   9 to build this target.  For some compilers, this results in adding a
  10 flag such as ``-std=gnu++11`` to the compile line.
  11
  12 Supported values are:
  13
  14 ``98``
  15   CUDA C++98. Note that this maps to the same as ``03`` internally.
  16
  17 ``03``
  18   CUDA C++03
  19
  20 ``11``
  21   CUDA C++11
  22
  23 ``14``
  24   CUDA C++14. While CMake 3.8 and later *recognize* ``14`` as a valid value,
  25   CMake 3.9 was the first version to include support for any compiler.
  26
  27 ``17``
  28   CUDA C++17. While CMake 3.8 and later *recognize* ``17`` as a valid value,
  29   CMake 3.18 was the first version to include support for any compiler.
  30
  31 ``20``
  32   .. versionadded:: 3.12
  33
  34   CUDA C++20. While CMake 3.12 and later *recognize* ``20`` as a valid value,
  35   CMake 3.18 was the first version to include support for any compiler.
  36
  37 ``23``
  38   .. versionadded:: 3.20
  39
  40   CUDA C++23
  41
  42 If the value requested does not result in a compile flag being added for
  43 the compiler in use, a previous standard flag will be added instead.  This
  44 means that using:
  45
  46 .. code-block:: cmake
  47
  48   set_property(TARGET tgt PROPERTY CUDA_STANDARD 11)
  49
  50 with a compiler which does not support ``-std=gnu++11`` or an equivalent
  51 flag will not result in an error or warning, but will instead add the
  52 ``-std=gnu++03`` flag if supported.  This "decay" behavior may be controlled
  53 with the :prop_tgt:`CUDA_STANDARD_REQUIRED` target property.
  54 Additionally, the :prop_tgt:`CUDA_EXTENSIONS` target property may be used to
  55 control whether compiler-specific extensions are enabled on a per-target basis.
  56
  57 See the :manual:`cmake-compile-features(7)` manual for information on
  58 compile features and a list of supported compilers.
  59
  60 This property is initialized by the value of
  61 the :variable:`CMAKE_CUDA_STANDARD` variable if it is set when a target
  62 is created.