Help/prop_tgt/OBJCXX_STANDARD.rst

   1 OBJCXX_STANDARD
   2 ---------------
   3
   4 .. versionadded:: 3.16
   5
   6 The ObjC++ standard whose features are requested to build this target.
   7
   8 This property specifies the ObjC++ 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   Objective C++98
  16
  17 ``11``
  18   Objective C++11
  19
  20 ``14``
  21   Objective C++14
  22
  23 ``17``
  24   Objective C++17
  25
  26 ``20``
  27   Objective C++20
  28
  29 ``23``
  30   .. versionadded:: 3.20
  31
  32   Objective C++23
  33
  34 ``26``
  35   .. versionadded:: 3.25
  36
  37   Objective C++26. CMake 3.25 and later *recognize* ``26`` as a valid value,
  38   no version has support for any compiler.
  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 OBJCXX_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:`OBJCXX_STANDARD_REQUIRED` target property.
  52 Additionally, the :prop_tgt:`OBJCXX_EXTENSIONS` target property may be used to
  53 control whether compiler-specific extensions are enabled on a per-target basis.
  54
  55 If the property is not set, and the project has set the :prop_tgt:`CXX_STANDARD`,
  56 the value of :prop_tgt:`CXX_STANDARD` is set for :prop_tgt:`OBJCXX_STANDARD`.
  57
  58 See the :manual:`cmake-compile-features(7)` manual for information on
  59 compile features and a list of supported compilers.
  60
  61 This property is initialized by the value of
  62 the :variable:`CMAKE_OBJCXX_STANDARD` variable if it is set when a target
  63 is created.