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()