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.