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

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

CMAKE_REQUIRED_INCLUDES

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

CMAKE_REQUIRED_LINK_OPTIONS

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

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

CMAKE_REQUIRED_LIBRARIES

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

CMAKE_REQUIRED_QUIET

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

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