CXX_SCAN_FOR_MODULES — CMake 3.26.3 Documentation

# CXX_SCAN_FOR_MODULES

New in version 3.26.

`CXX_SCAN_FOR_MODULES` is a boolean specifying whether CMake will scan C++ sources in the target for module dependencies. See also the `CXX_SCAN_FOR_MODULES` for per-source settings which, if set, overrides the target-wide settings.

This property is initialized by the value of the `CMAKE_CXX_SCAN_FOR_MODULES` variable if it is set when a target is created.

When this property is set `ON` or unset, CMake will scan the target's `CXX` sources at build time and add module dependency information to the compile line as necessary. When this property is set `OFF`, CMake will not scan the target's `CXX` sources at build time.

Note that scanning is only performed if C++20 or higher is enabled for the target. Scanning for modules in the target's sources belonging to file sets of type `CXX_MODULES` and `CXX_MODULES_HEADER_UNITS` is always performed.

Note

This setting is meaningful only when experimental support for C++ modules has been enabled by the `CMAKE_EXPERIMENTAL_CXX_MODULE_CMAKE_API` gate.