Spec-Zone.ru › CMake

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_policy() или cmake_minimum_required(). Если она не установлена, CMake выводит предупреждение и использует поведение OLD.

Примечание

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

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

Spec-Zone.ru

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