Spec-Zone.ru › CMake 3.31

COMPILE_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.31/prop_tgt/COMPILE_DEFINITIONS.html

Spec-Zone.ru

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