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

Проверить, компилируется ли предоставленный исходный код 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

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

CMAKE_REQUIRED_DEFINITIONS

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

CMAKE_REQUIRED_INCLUDES

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

CMAKE_REQUIRED_LINK_OPTIONS

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

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

CMAKE_REQUIRED_LIBRARIES

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

CMAKE_REQUIRED_QUIET

Новая в версии 3.1.

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