Spec-Zone.ru › CMake 3.17

CMP0053

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

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.17.5 предупреждает, когда политика не установлена, и использует поведение OLD. Используйте команду cmake_policy(), чтобы установить её явно в OLD или NEW.

Примечание

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

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

Spec-Zone.ru

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