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>, со значением true для успеха и false для неудачи.

Если 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

Новое в версии 3.14.

;-список опций для добавления в команду линковки (см. try_compile() для получения дополнительной информации).

CMAKE_REQUIRED_LIBRARIES

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

CMAKE_REQUIRED_QUIET

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

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