CheckSourceRuns

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

check_source_runs

check_source_runs(<lang> <code> <resultVar>
                  [SRC_EXT <extension>])

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

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

<code> должен содержать корректную главную программу. Например:

check_source_runs(C
"#include <stdlib.h>
#include <stdnoreturn.h>
noreturn void f(){ exit(0); }
int main(void) { f(); return 1; }"
HAVE_NORETURN)

check_source_runs(Fortran
"program test
real :: x[*]
call co_sum(x)
end program"
HAVE_COARRAY)

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

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

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

New in version 3.14.

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

CMAKE_REQUIRED_LIBRARIES

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

CMAKE_REQUIRED_QUIET

New in version 3.1.

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