CheckFortranSourceCompiles

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

check_fortran_source_compiles

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

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

check_fortran_source_compiles("program test
error stop
end program"
HAVE_ERROR_STOP
SRC_EXT .F90)

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

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

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

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

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

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

CMAKE_REQUIRED_FLAGS

Строка дополнительных флагов, которые нужно передать компилятору. Строка должна быть разделена пробелами — ;-list не сработает. Содержимое CMAKE_<LANG>_FLAGS и его соответствующей переменной, специфичной для конфигурации, автоматически добавляется к команде компилятора перед содержимым CMAKE_REQUIRED_FLAGS.

CMAKE_REQUIRED_DEFINITIONS

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

CMAKE_REQUIRED_INCLUDES

;-list путей поиска заголовков, которые нужно передать компилятору. Это будут единственные пути поиска заголовков — содержимое свойства каталога INCLUDE_DIRECTORIES будет проигнорировано.

CMAKE_REQUIRED_LINK_OPTIONS

New in version 3.14.

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

CMAKE_REQUIRED_LIBRARIES

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

CMAKE_REQUIRED_QUIET

New in version 3.1.

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