Spec-Zone.ru › CMake 3.22

COMPILE_DEFINITIONS

Препроцессорные определения для компиляции исходных кодов целевого объекта.

Свойство COMPILE_DEFINITIONS может быть установлено в виде списка препроцессорных определений, разделённых точкой с запятой, используя синтаксис VAR или VAR=value. Определения в стиле функций не поддерживаются. CMake автоматически правильно экранирует значение для родной системы сборки (обратите внимание, что синтаксис CMake может потребовать экранирования для задания некоторых значений).

CMake автоматически удалит некоторые определения, которые не поддерживаются родным инструментом сборки.

Оговорка: большинство родных инструментов сборки слабо поддерживают экранирование определённых значений. CMake имеет обходные пути для многих случаев, но некоторые значения могут просто не быть корректно переданы. Если значение, кажется, не экранировано корректно, не пытайтесь обойти проблему, добавляя последовательности экранирования к значению. Ваш обходной путь может сломаться в будущей версии CMake, у которой улучшена поддержка экранирования. Вместо этого рассмотрите возможность определения макроса в (конфигурируемом) файле заголовков. Затем сообщите об ограничении. Известные ограничения включают:

#          - broken almost everywhere
;          - broken in VS IDE 7.0 and Borland Makefiles
,          - broken in VS IDE
%          - broken in some cases in NMake
& |        - broken in some cases on MinGW
^ < > \"   - broken in most Make tools on Windows

CMake не отклоняет эти значения напрямую, так как они работают в некоторых случаях. Используйте с осторожностью.

Содержание COMPILE_DEFINITIONS может использовать "генераторные выражения" с синтаксисом $<...>. См. руководство cmake-generator-expressions(7) для доступных выражений. См. руководство cmake-buildsystem(7) для получения дополнительной информации об определении свойств системы сборки.

Соответствующее свойство COMPILE_DEFINITIONS_<CONFIG> может быть установлено для задания определений по конфигурациям. Вместо настройки альтернативного свойства рекомендуется использовать генераторные выражения.

© 2000–2021 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/v3.22/prop_tgt/COMPILE_DEFINITIONS.html

Spec-Zone.ru

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