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

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

check_c_source_compiles

check_c_source_compiles(code resultVar [FAIL_REGEX regex1 [regex2...]])

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

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

CMAKE_REQUIRED_FLAGS

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

CMAKE_REQUIRED_DEFINITIONS

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

CMAKE_REQUIRED_INCLUDES

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

CMAKE_REQUIRED_LIBRARIES

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

CMAKE_REQUIRED_QUIET

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

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