cppstat.dev

---

---

cppstat is a site that lists C++ features and their respective support by compilers and standard libraries, designed as a simple, quickly searchable table.

Contributing

cppstat is generated from YAML data files in the root directory. The files are maintained as a best-effort and contributions are always welcome.

You can edit these files directly via GitHub's web interface and commit your changes for approval.

Alternatively, you can submit a ticket for any incorrect or missing information, or feature ideas.

If you are a toolchain or compiler vendor, feel free to request full editorial access.

---

Feature Lists

Features are declared in the features_cpp<version>.yaml files. Each standard version of C++ has its own file; for example, features_cpp23.yaml contains all features of C++23.

A feature has the following properties:

• desc: The title and / or description of the feature. Supports Markdown.
• paper: One or multiple paper numbers that belong to the feature.
• lib: If true, the feature counts as a standard library feature. The default is false.
• support: A list of toolchains that support the feature.
  • A toolchain must be in the form of <name> <version>, e.g. GCC 16 and MSVC 19.50.
    • If no version is specified, e.g. GCC, then that toolchain supports the feature in general.
  • Adding a (partial) or (hint) suffix declares partial support or a hint.
• hints: A list of hints targeting toolchains in the support list, where each entry has:
  • target: The toolchain that this hint targets
  • msg: The reason for partial support, or the hint. Supports Markdown.
• ftm: A list of feature-testing macros (FTM) for the feature, where each entry has:
  • name: The name of the FTM, e.g. __cpp_lib_not_fn
  • value: The value of the FTM, e.g. 201603L
• content: Information about the feature (see below)

As a full reference example, here is the definition of P2465 at the time of writing:

- desc: 'Standard library modules (`import std`)'
  paper: P2465
  lib: true
  support:
    - GCC 15 (hint)
    - Clang 17 (partial)
    - Clang 19
    - MSVC 19.35 (partial)
    - MSVC 19.36
  hints:
    - target: GCC 15
      msg: 'Requires enabling compiler flag `-fmodules` to enable experimental modules support.'
    - target: Clang 17
      msg: 'Experimental support only.'
    - target: MSVC 19.35
      msg: 'Modules work, but you have to manually add them to your Visual Studio project.'
  ftm:
    - name: __cpp_lib_modules
      value: 202207L

Which will look like the following on cppstat:

---

Feature Content

Every feature can have an in-depth explanation hidden behind its info button.

The content property of a feature specifies the Markdown file that describes the feature. This file is expected to be in the content folder.

For example, the feature P2589 (static operator[]) is defined as follows:

- desc: '`static operator[]`'
  ...
  content: p2589_static_subscript_operator.md

This feature's explanation is therefore expected to be in content/p2589_static_subscript_operator.md.

Note

Although the name of the file does not matter, it should at least include the paper's name.

---

Toolchains

Toolchains are declared in the toolchains.yaml file.

Note that the list does not contain every possible toolchain release, but rather the toolchains that are referenced by a feature. This is mostly major and minor releases, very rarely revisions.

Each toolchain has the following properties:

• name: The name and version of the toolchain, e.g. GCC 11.5
• released: The official release date of the toolchain, e.g. July 19, 2024
• refs: An optional list of related websites, such as release note links

MSVC has the following additional properties:

• part_of: The version of Visual Studio that the MSVC release was a part of, e.g. Visual Studio 2019 version 16.1

Xcode has the following additional properties:

• apple_clang: The version of the Apple Clang compiler that was part of the Xcode release, e.g. 13.0.0 (clang-1300.0.29.3)