CMAKE_CURRENT_FUNCTION_LIST_DIR

При выполнении кода внутри 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.