Spec-Zone.ru › CMake 3.26

CMP0053

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

Упрощение обработки ссылок на переменные и последовательностей escape.

CMake 3.1 представил значительно более быструю реализацию оценки ссылок на переменные и последовательностей escape, документированных в cmake-language(7) руководстве. Хотя поведение в большинстве случаев идентично предыдущей реализации, были устранены некоторые частные случаи для упрощения работы. В частности:

  • Расширение синтаксиса ссылок @VAR@, определенного командами configure_file() и string(CONFIGURE), больше не выполняется в других контекстах.
  • Литеральный синтаксис ссылок ${VAR} может содержать только символы алфавитно-цифрового диапазона (A-Z, a-z, 0-9) и символы _, ., /, -, и +. Обратите внимание, что $ технически разрешён в поведении NEW, но недействителен для поведения OLD. Это связано с упущением при реализации CMP0053, и поэтому использование его в качестве литеральной ссылки на переменную не рекомендуется. Переменные с другими символами в имени по-прежнему могут ссылаться косвенно, например:

    set(varname "otherwise & disallowed $ characters")
    message("${${varname}}")
    
  • Указание политики CMP0010 не учитывается, поэтому неправильный синтаксис ссылки на переменную всегда является ошибкой.
  • Разрешены дополнительные символы для экранирования в именах переменных. Ранее только ()#" \@^ были допустимыми символами для экранирования. Теперь любой неалфавитно-цифровой, неточковый и не-NUL символ может быть экранирован после escape_identity производства в разделе последовательностей escape cmake-language(7) руководства.

Поведением OLD для этой политики является соблюдение предыдущего поведения для ссылок на переменные и последовательностей escape. Поведением NEW является использование более простых правил расширения переменных и оценки последовательностей escape.

Эта политика была введена в CMake версии 3.1. CMake версии 3.26.0-rc3 предупреждает, если политика не установлена, и использует OLD поведение. Используйте команду cmake_policy() для явного её установки в OLD или NEW.

Примечание

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

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

Spec-Zone.ru

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