CheckFortranSourceRuns

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

check_fortran_source_runs

check_fortran_source_runs(<code> <resultVar>
    [SRC_EXT <extension>])

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

check_fortran_source_runs("real :: x[*]; call co_sum(x); end" F2018coarrayOK)

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

Если <code> была успешно построена и запущена, внутренняя переменная кэша, указанная в <resultVar>, будет установлена в 1, в противном случае она будет установлена в значение, которое оценивается как логический ноль (например, пустая строка или сообщение об ошибке).

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

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

CMAKE_REQUIRED_FLAGS

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

CMAKE_REQUIRED_DEFINITIONS

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

CMAKE_REQUIRED_INCLUDES

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

CMAKE_REQUIRED_LINK_OPTIONS

Список параметров, которые необходимо добавить к команде компоновки (подробнее см. в try_run()).

CMAKE_REQUIRED_LIBRARIES

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

CMAKE_REQUIRED_QUIET

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

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