CheckCSourceRuns

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

check_c_source_runs

check_c_source_runs(<code> <resultVar>)

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

Основная проверка выполняется командой try_run(). Команды компиляции и линковки можно настроить, задав следующие переменные перед вызовом check_c_source_runs():

CMAKE_REQUIRED_FLAGS

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

CMAKE_REQUIRED_DEFINITIONS

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

CMAKE_REQUIRED_INCLUDES

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

CMAKE_REQUIRED_LINK_OPTIONS

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

Список (с разделителем «-») опций для добавления к команде линковки (см. try_run() для получения дополнительных сведений).

CMAKE_REQUIRED_LIBRARIES

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

CMAKE_REQUIRED_QUIET

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

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

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