Проверка компиляции C++ исходного кода

Проверить, можно ли скомпилировать и слинковать данный C++ исходный код в исполняемый файл.

check_cxx_source_compiles

check_cxx_source_compiles(code resultVar [FAIL_REGEX regex1 [regex2...]])

Проверить, что предоставленный в code исходный код может быть скомпилирован как C++ исходный файл и слинкован в исполняемый файл (он должен содержать как минимум функцию main()). Результат будет сохранён во внутренней переменной кэша, указанной в resultVar, с булевым значением true для успеха и false для неудачи. Если FAIL_REGEX предоставлено, то неудача определяется по соответствию вывода заданным регулярным выражениям.

Основная проверка выполняется командой try_compile(). Команды компиляции и линковки могут быть изменены, задав соответствующие переменные до вызова check_cxx_source_compiles():

CMAKE_REQUIRED_FLAGS

Дополнительные флаги для компилятора. Обратите внимание, что содержимое CMAKE_CXX_FLAGS и его соответствующая конфигурационная переменная автоматически добавляются к команде компилятора перед содержимым CMAKE_REQUIRED_FLAGS.

CMAKE_REQUIRED_DEFINITIONS

Список (с разделителем ';') определений компилятора в формате -DFOO или -DFOO=bar. Определение для имени, указанного в resultVar, также будет автоматически добавлено.

CMAKE_REQUIRED_INCLUDES

Список (с разделителем ';') путей поиска заголовков для компилятора. Это будут единственные пути поиска заголовков, используемые try_compile(), т.е. содержимое свойства директории INCLUDE_DIRECTORIES будет проигнорировано.

CMAKE_REQUIRED_LIBRARIES

Список (с разделителем ';') библиотек для добавления в команду линковки. Это могут быть имена системных библиотек или Импортированные цели (подробнее см. в try_compile()).

CMAKE_REQUIRED_QUIET

Если значение этой переменной истинно, все сообщения о статусе, связанные с проверкой, будут подавлены.

Проверка выполняется только один раз, и результат кэшируется в переменной, имя которой указано в resultVar. Каждый последующий запуск CMake будет использовать это кэшированное значение, а не выполнять проверку снова, даже если code изменились. Чтобы заставить переоценить проверку, переменную, имя которой указано в resultVar, необходимо удалить из кэша.