COMPILE_DEFINITIONS

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

Это свойство задаёт список опций, предоставленных до сих пор команде add_compile_definitions() (или add_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> может быть установлено для указания определений по конфигурациям. Генераторные выражения следует предпочитать вместо установки альтернативного свойства.