tree: 00fff582e8b7aa3a64a8c08c717d884b957e03dd [path history] [tgz]
  1. std/
  2. std.compat/
  3. .clang-format
  4. CMakeLists.txt
  5. CMakeLists.txt.in
  6. modules.json.in
  7. README.md
  8. std.compat.cppm.in
  9. std.cppm.in
libcxx/modules/README.md

The “module partitions” for the std module

The files in this directory contain the exported named declarations per header. These files are used for the following purposes:

  • During testing exported named declarations are tested against the named declarations in the associated header. This excludes reserved names; they are not exported.
  • Generate the module std.

These use cases require including the required headers for these “partitions” at different locations. This means the user of these “partitions” are responsible for including the proper header and validating whether the header can be loaded in the current libc++ configuration. For example “include ” fails when locales are not available. The “partitions” use the libc++ feature macros to export the declarations available in the current configuration. This configuration is available if the user includes the `__config' header.

We use .inc files that we include from the top-level module instead of using real C++ module partitions. This is a lot faster than module partitions, see this for details.