CMAKE_FIND_USE_INSTALL_PREFIX

加入於版本 3.24。

控制以下命令的預設行為，以決定是否搜尋 CMAKE_INSTALL_PREFIX 和 CMAKE_STAGING_PREFIX 變數中的位置。

• find_program()

• find_library()

• find_file()

• find_path()

• find_package()

這在跨編譯環境中很有用。

由於與 CMAKE_FIND_NO_INSTALL_PREFIX 的向後相容性，find 命令的行為會根據此變數是否存在而改變。

CMAKE_FIND_USE_INSTALL_PREFIX	CMAKE_FIND_NO_INSTALL_PREFIX	搜尋
未定義	開啟	否
未定義	關閉 || 未定義	是
關閉	開啟	否
關閉	關閉 || 未定義	否
開啟	開啟	是
開啟	關閉 || 未定義	是

預設情況下，此變數未定義。給予上述命令的明確選項優先於此變數。

另請參閱 CMAKE_FIND_USE_CMAKE_PATH、 CMAKE_FIND_USE_CMAKE_ENVIRONMENT_PATH、 CMAKE_FIND_USE_SYSTEM_ENVIRONMENT_PATH、 CMAKE_FIND_USE_SYSTEM_PACKAGE_REGISTRY、 CMAKE_FIND_USE_PACKAGE_REGISTRY 和 CMAKE_FIND_USE_PACKAGE_ROOT_PATH 變數。