Spec-Zone.ru › CMake 3.29

CMAKE_CURRENT_FUNCTION_LIST_DIR

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

При выполнении кода внутри function(), эта переменная содержит полный путь к файлу списка, который определил текущую функцию.

В CMake модули часто используют дополнительные файлы, такие как шаблоны, которые нужно скопировать после подстановки переменных CMake. В таких случаях функция должна знать, где найти эти файлы независимо от места вызова функции. Без CMAKE_CURRENT_FUNCTION_LIST_DIR, для этого обычно используется следующий шаблон:

set(_THIS_MODULE_BASE_DIR "${CMAKE_CURRENT_LIST_DIR}")

function(foo)
  configure_file(
    "${_THIS_MODULE_BASE_DIR}/some.template.in"
    some.output
  )
endfunction()

Использование CMAKE_CURRENT_FUNCTION_LIST_DIR внутри функции исключает необходимость дополнительной переменной, которая в противном случае была бы видимой за пределами области видимости функции. Приведённый выше пример можно записать более кратко и надёжно:

function(foo)
  configure_file(
    "${CMAKE_CURRENT_FUNCTION_LIST_DIR}/some.template.in"
    some.output
  )
endfunction()

См. также CMAKE_CURRENT_FUNCTION, CMAKE_CURRENT_FUNCTION_LIST_FILE и CMAKE_CURRENT_FUNCTION_LIST_LINE.

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

Spec-Zone.ru

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