Spec-Zone.ru › CMake 3.28

CMP0053

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

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

CMake 3.1 представил значительно более быструю реализацию оценки ссылок на переменные и последовательностей экранирования, документированных в руководстве 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 в разделе последовательности экранирования руководства cmake-language(7).

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

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

Примечание

Поведение 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/CMP0053.html

Spec-Zone.ru

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