Spec-Zone.ru › CMake 3.27

COMPILE_DEFINITIONS

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

Это свойство задаёт список опций, предоставленных до сих пор команде add_compile_definitions() (или add_definitions()).

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

Это свойство будет инициализировано в каждом каталоге своим значением из родительского каталога.

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

Добавлено в версии 3.26: Любой начальный -D в элементе будет удалён.

Оговорка: большинство системных инструментов сборки слабо поддерживают экранирование определённых значений. 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–2024 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/v3.27/prop_dir/COMPILE_DEFINITIONS.html

Spec-Zone.ru

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