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.