Проверка выполнения C-исходного кода
Проверяет, компилируется ли заданный C-исходный код, линкуется ли он в исполняемый файл и может ли он быть затем запущен.
-
check_c_source_runs -
check_c_source_runs(code resultVar)
Проверяет, что предоставленный в
codeисходный код может быть скомпилирован как C-исходный файл, слинкован как исполняемый файл и затем запущен. Вcodeдолжен быть по крайней мере одинmain()функция. Если код был успешно построен и запущен, внутренняя переменная кэша, указанная вresultVar, будет установлена в 1, в противном случае она будет установлена в значение, эквивалентное логическому false (например, пустая строка или сообщение об ошибке).Основная проверка выполняется командой
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_LIBRARIES - Список библиотек для добавления в команду линкерования. Это может быть имя системных библиотек, или это могут быть Импортированные целевые объекты (см.
try_run()для получения дополнительной информации). -
CMAKE_REQUIRED_QUIET - Если эта переменная имеет значение логической истины, все сообщения статуса, связанные с проверкой, будут подавлены.
Проверка выполняется только один раз, и результат кэшируется в переменной, имя которой указано в
resultVar. Каждый последующий запуск CMake будет повторно использовать это кэшированное значение вместо выполнения проверки заново, даже еслиcodeизменился. Для того, чтобы заставить проверку быть переоценённой, переменную с именемresultVarнеобходимо удалить из кэша вручную. -
© 2000–2019 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/v3.13/module/CheckCSourceRuns.html