Spec-Zone.ru › CMake 3.27

Проверка выполнения исходного кода C

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

check_c_source_runs
check_c_source_runs(<code> <resultVar>)

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

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

Команды компиляции и линковки могут быть изменены, если перед вызовом check_c_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

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

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

CMAKE_REQUIRED_LIBRARIES

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

CMAKE_REQUIRED_QUIET

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

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

© 2000–2024 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/v3.27/module/CheckCSourceRuns.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API