kolan
/
CMake
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity
CMake/Help/prop_tgt/CXX_STANDARD.rst

32 lines
1.2 KiB
ReStructuredText
Raw Normal View History

cmTarget: Add CXX_STANDARD and CXX_EXTENSION target properties. These are used to determine whether to add -std=c++11, -std=gnu++11 etc flags on the compile line.
2013-10-13 04:00:24 +04:00
CXX_STANDARD
------------
Features: Decay language flag if requested is not available. Use the highest standard compile flags available if requested language version is too new. This supports use-cases like set(CMAKE_CXX_STANDARD 14) # Compiled with -std=c++11 with GNU 4.7, which has no -std=c++14 # or equivalent flag add_executable(main main.cpp) This can be used in combination with preprocessor defines which communicate the availability of certain language features for optional use.
2014-03-28 19:09:35 +04:00
The C++ standard whose features are requested to build this target.
cmTarget: Add CXX_STANDARD and CXX_EXTENSION target properties. These are used to determine whether to add -std=c++11, -std=gnu++11 etc flags on the compile line.
2013-10-13 04:00:24 +04:00
Features: Decay language flag if requested is not available. Use the highest standard compile flags available if requested language version is too new. This supports use-cases like set(CMAKE_CXX_STANDARD 14) # Compiled with -std=c++11 with GNU 4.7, which has no -std=c++14 # or equivalent flag add_executable(main main.cpp) This can be used in combination with preprocessor defines which communicate the availability of certain language features for optional use.
2014-03-28 19:09:35 +04:00
This property specifies the C++ standard whose features are requested
cmTarget: Add CXX_STANDARD and CXX_EXTENSION target properties. These are used to determine whether to add -std=c++11, -std=gnu++11 etc flags on the compile line.
2013-10-13 04:00:24 +04:00
to build this target. For some compilers, this results in adding a
Features: Define meaning for no language standard default Define an empty string in CMAKE_<LANG>_STANDARD_DEFAULT to mean that the toolchain has no notion of lanuage standard levels. In this case the <LANG>_STANDARD[_REQUIRED] properties will have no effect. Update the RunCMake.CompileFeatures test to exclude the LinkImplementationFeatureCycle test when there is no standard default. It can never fail because no use of specific features will adjust the CXX_STANDARD level required for any target since the standard levels have no meaning in this case.
2015-01-27 00:42:36 +03:00
flag such as ``-std=gnu++11`` to the compile line. For compilers that
have no notion of a standard level, such as MSVC, this has no effect.
cmTarget: Add CXX_STANDARD and CXX_EXTENSION target properties. These are used to determine whether to add -std=c++11, -std=gnu++11 etc flags on the compile line.
2013-10-13 04:00:24 +04:00
Help: Document valid 14 value for CXX_STANDARD. (#15339) Support was added in commit v3.1.0-rc1~475^2 (Features: Add support for C++14 features., 2014-05-06), but the documentation for this property was not amended.
2015-01-08 21:41:23 +03:00
Supported values are ``98``, ``11`` and ``14``.
cmTarget: Add CXX_STANDARD and CXX_EXTENSION target properties. These are used to determine whether to add -std=c++11, -std=gnu++11 etc flags on the compile line.
2013-10-13 04:00:24 +04:00
Features: Decay language flag if requested is not available. Use the highest standard compile flags available if requested language version is too new. This supports use-cases like set(CMAKE_CXX_STANDARD 14) # Compiled with -std=c++11 with GNU 4.7, which has no -std=c++14 # or equivalent flag add_executable(main main.cpp) This can be used in combination with preprocessor defines which communicate the availability of certain language features for optional use.
2014-03-28 19:09:35 +04:00
If the value requested does not result in a compile flag being added for
the compiler in use, a previous standard flag will be added instead. This
means that using:
.. code-block:: cmake
set_property(TARGET tgt PROPERTY CXX_STANDARD 11)
Features: Enable compiler extensions by default. Compilers enable their extensions by default, and disabling them implicitly can lead to results which are surprising or non-obvious to debug. http://public.kitware.com/pipermail/cmake-developers/2014-May/010575.html http://thread.gmane.org/gmane.comp.programming.tools.cmake.devel/10214 https://www.mail-archive.com/cmake-developers@cmake.org/msg10116.html (Compiler feature extensions by default, 29 May 2014)
2014-05-30 17:03:45 +04:00
with a compiler which does not support ``-std=gnu++11`` or an equivalent
Features: Decay language flag if requested is not available. Use the highest standard compile flags available if requested language version is too new. This supports use-cases like set(CMAKE_CXX_STANDARD 14) # Compiled with -std=c++11 with GNU 4.7, which has no -std=c++14 # or equivalent flag add_executable(main main.cpp) This can be used in combination with preprocessor defines which communicate the availability of certain language features for optional use.
2014-03-28 19:09:35 +04:00
flag will not result in an error or warning, but will instead add the
Features: Enable compiler extensions by default. Compilers enable their extensions by default, and disabling them implicitly can lead to results which are surprising or non-obvious to debug. http://public.kitware.com/pipermail/cmake-developers/2014-May/010575.html http://thread.gmane.org/gmane.comp.programming.tools.cmake.devel/10214 https://www.mail-archive.com/cmake-developers@cmake.org/msg10116.html (Compiler feature extensions by default, 29 May 2014)
2014-05-30 17:03:45 +04:00
``-std=gnu++98`` flag if supported. This "decay" behavior may be controlled
cmTarget: Add CXX_STANDARD_REQUIRED to control decay.
2014-04-30 20:07:38 +04:00
with the :prop_tgt:`CXX_STANDARD_REQUIRED` target property.
Features: Decay language flag if requested is not available. Use the highest standard compile flags available if requested language version is too new. This supports use-cases like set(CMAKE_CXX_STANDARD 14) # Compiled with -std=c++11 with GNU 4.7, which has no -std=c++14 # or equivalent flag add_executable(main main.cpp) This can be used in combination with preprocessor defines which communicate the availability of certain language features for optional use.
2014-03-28 19:09:35 +04:00
Help: Add a manual for compiler feature control. Link to it from the documentation of related properties, variables and commands. Extend the cmake-developer(7) documentation with notes on extending feature support for compilers.
2014-03-19 02:50:18 +04:00
See the :manual:`cmake-compile-features(7)` manual for information on
Help: Document supported compilers in cmake-compile-features.7 Extend sentences in other documentation linking to this manual to say that it has a list of supported compilers. Co-Author: Brad King <brad.king@kitware.com>
2015-04-07 21:10:50 +03:00
compile features and a list of supported compilers.
Help: Add a manual for compiler feature control. Link to it from the documentation of related properties, variables and commands. Extend the cmake-developer(7) documentation with notes on extending feature support for compilers.
2014-03-19 02:50:18 +04:00
cmTarget: Add CXX_STANDARD and CXX_EXTENSION target properties. These are used to determine whether to add -std=c++11, -std=gnu++11 etc flags on the compile line.
2013-10-13 04:00:24 +04:00
This property is initialized by the value of
the :variable:`CMAKE_CXX_STANDARD` variable if it is set when a target
is created.