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