CheckFortranSourceCompiles

Проверяет, компилируется ли заданный Fortran-код и создается ли из него исполняемый файл.

check_fortran_source_compiles

check_fortran_source_compiles(<code> <resultVar>
    [FAIL_REGEX <regex>...]
    [SRC_EXT <extension>]
)

Проверяет, что исходный код, предоставленный в <code>, может быть скомпилирован как Fortran-исходный файл и скомпонован в исполняемый файл. <code> должен быть Fortran-программой, содержащей по крайней мере оператор end, например:

check_fortran_source_compiles("character :: b; error stop b; end" F2018ESTOPOK SRC_EXT F90)

Эта команда может помочь избежать дорогостоящих процессов сборки, когда компилятор не поддерживает необходимую функцию или определённая библиотека поставщика несовместима с используемой версией Fortran-компилятора. Эта проверка, выполняемая на стадии генерации, может предупредить пользователя об этом до начала основного процесса сборки. Также см. команду check_fortran_source_runs() для фактического запуска скомпилированного кода.

Результат будет сохранён во внутренней переменной кэша <resultVar>, с истинным значением булевого типа для успеха и ложным значением булевого типа для неудачи.

Если FAIL_REGEX предоставлен, то неудача определяется по проверке, совпадает ли что-либо в выводе с любым из указанных регулярных выражений.

По умолчанию тестовый исходный файл получит расширение .F. Опцию SRC_EXT можно использовать для переопределения этого расширения на .<extension> вместо него — .F90 является типичным выбором.

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

CMAKE_REQUIRED_FLAGS

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

CMAKE_REQUIRED_DEFINITIONS

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

CMAKE_REQUIRED_INCLUDES

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

CMAKE_REQUIRED_LINK_OPTIONS

Список опций для добавления к команде компоновки (см. try_compile() для дополнительных сведений).

CMAKE_REQUIRED_LIBRARIES

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

CMAKE_REQUIRED_QUIET

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

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