Help/prop_tgt/CXX_STANDARD.rst

   1 CXX_STANDARD
   2 ------------
   3
   4 .. versionadded:: 3.1
   5
   6 The C++ standard whose features are requested to build this target.
   7
   8 This property specifies the 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.  For compilers that
  11 have no notion of a standard level, such as Microsoft Visual C++ before
  12 2015 Update 3, this has no effect.
  13
  14 Supported values are:
  15
  16 ``98``
  17   C++98
  18
  19 ``11``
  20   C++11
  21
  22 ``14``
  23   C++14
  24
  25 ``17``
  26   .. versionadded:: 3.8
  27
  28   C++17
  29
  30 ``20``
  31   .. versionadded:: 3.12
  32
  33   C++20
  34
  35 ``23``
  36   .. versionadded:: 3.20
  37
  38   C++23
  39
  40 If the value requested does not result in a compile flag being added for
  41 the compiler in use, a previous standard flag will be added instead.  This
  42 means that using:
  43
  44 .. code-block:: cmake
  45
  46   set_property(TARGET tgt PROPERTY CXX_STANDARD 11)
  47
  48 with a compiler which does not support ``-std=gnu++11`` or an equivalent
  49 flag will not result in an error or warning, but will instead add the
  50 ``-std=gnu++98`` flag if supported.  This "decay" behavior may be controlled
  51 with the :prop_tgt:`CXX_STANDARD_REQUIRED` target property.
  52 Additionally, the :prop_tgt:`CXX_EXTENSIONS` target property may be used to
  53 control whether compiler-specific extensions are enabled on a per-target basis.
  54
  55 See the :manual:`cmake-compile-features(7)` manual for information on
  56 compile features and a list of supported compilers.
  57
  58 This property is initialized by the value of
  59 the :variable:`CMAKE_CXX_STANDARD` variable if it is set when a target
  60 is created.