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.