Spec-Zone.ru › CMake 3.28

CMP0126

Новое в версии 3.21.

Когда эта политика установлена в NEW, команда set(CACHE) не удаляет никакие обычные переменные с тем же именем из текущей области видимости. Поведение OLD удаляет любые обычные переменные с тем же именем из текущей области видимости в следующих ситуациях:

  • Ранее не существовала переменная кеша с таким именем.
  • Ранее существовала переменная кеша с таким именем, но она не имела типа. Это может произойти, когда переменная была установлена в командной строке с помощью формы, подобной cmake -DMYVAR=blah вместо cmake -DMYVAR:STRING=blah.
  • При установке переменной кеша использовались ключевые слова FORCE или INTERNAL.

Обратите внимание, что поведение NEW имеет важное отличие от аналогичного поведения NEW политики CMP0077. Команда set(CACHE) всегда устанавливает переменную кеша, если она ранее не существовала, независимо от настройки политики CMP0126. Команда option() не установит переменную кеша, если уже существует переменная, не относящаяся к кешу, с тем же именем и CMP0077 установлено в NEW.

Политика CMP0126 была введена в CMake версии 3.21. Используйте команду cmake_policy() для явного задания ей значения OLD или NEW в рамках проекта. Используйте переменную CMAKE_POLICY_DEFAULT_CMP0126 для установки политики для проекта сторонних разработчиков в подкаталоге без его изменения. В отличие от многих политик, CMake версии 3.28.6 не выдает предупреждение, если политика не установлена, и просто использует поведение OLD. См. документацию переменной CMAKE_POLICY_WARNING_CMP0126 для управления предупреждением.

Примечание

Поведение OLD политики deprecated by definition и может быть удалено в будущих версиях CMake.

© 2000–2024 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/v3.28/policy/CMP0126.html

Spec-Zone.ru

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