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 If the value requested does not result in a compile flag being added for
  35 the compiler in use, a previous standard flag will be added instead.  This
  36 means that using:
  37
  38 .. code-block:: cmake
  39
  40   set_property(TARGET tgt PROPERTY OBJCXX_STANDARD 11)
  41
  42 with a compiler which does not support ``-std=gnu++11`` or an equivalent
  43 flag will not result in an error or warning, but will instead add the
  44 ``-std=gnu++98`` flag if supported.  This "decay" behavior may be controlled
  45 with the :prop_tgt:`OBJCXX_STANDARD_REQUIRED` target property.
  46 Additionally, the :prop_tgt:`OBJCXX_EXTENSIONS` target property may be used to
  47 control whether compiler-specific extensions are enabled on a per-target basis.
  48
  49 If the property is not set, and the project has set the :prop_tgt:`CXX_STANDARD`,
  50 the value of :prop_tgt:`CXX_STANDARD` is set for :prop_tgt:`OBJCXX_STANDARD`.
  51
  52 See the :manual:`cmake-compile-features(7)` manual for information on
  53 compile features and a list of supported compilers.
  54
  55 This property is initialized by the value of
  56 the :variable:`CMAKE_OBJCXX_STANDARD` variable if it is set when a target
  57 is created.