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.