CMAKE_<LANG>_STANDARD_LATEST¶
3.30 版本新增。
此变量表示当前编译器支持的语言 `<LANG>
` 的最新标准版本与 CMake 支持的最新标准版本之间的最小值。其值将设置为相应 `<LANG>_STANDARD
目标属性的受支持值之一;有关支持的语言列表,请参阅该属性的文档。
有关编译功能以及支持的编译器列表的信息,请参阅 cmake-compile-features(7)
手册。
注意
`CMAKE_<LANG>_STANDARD_LATEST` 永远不会设置为 CMake 识别但未提供支持的语言标准。除非另有明确说明,否则相应 `<LANG>_STANDARD
目标属性所支持的每个值都代表 CMake 识别并支持的语言 `<LANG>
` 的一个标准。
检查语言标准支持¶
可以使用 `CMAKE_<LANG>_STANDARD_LATEST
` 变量的值来检查语言标准支持。例如,这可以用来有条件地为分发库启用可选功能。
执行此操作时,应注意 **不要** 依赖于标准级别之间的整数值比较。这是因为 CMake 支持的给定语言的某些旧标准(例如 C++98,表示为 `98
`)的数值将大于同一语言的新标准。
以下代码示例演示了如何正确检查 C++17 支持
# Careful! We cannot do direct integer comparisons with
# CMAKE_CXX_STANDARD_LATEST because some earlier C++ standards (e.g.,
# C++98) will have a higher numerical value than our requirement (C++17).
#
# Instead, we keep a list of unsupported C++ standards and check if
# CMAKE_CXX_STANDARD_LATEST appears in that list.
set(UNSUPPORTED_CXX_STANDARDS
98
11
14
)
list(FIND UNSUPPORTED_CXX_STANDARDS ${CMAKE_CXX_STANDARD_LATEST} UNSUPPORTED_CXX_STANDARDS_INDEX)
if(UNSUPPORTED_CXX_STANDARDS_INDEX EQUAL -1)
# We know that the current compiler supports at least C++17. Enabling
# some optional feature...
else()
message(STATUS
"Feature X is disabled because it requires C++17, but the current "
"compiler only supports C++${CMAKE_CXX_STANDARD_LATEST}."
)
endif()