cmake find_file examples

Signatures

find_file (
  <VAR>
  name | NAMES name1 [name2 ...]
  [HINTS [path | ENV var]...]
  [PATHS [path | ENV var]...]
  [REGISTRY_VIEW (64|32|64_32|32_64|HOST|TARGET|BOTH)]
  [PATH_SUFFIXES suffix1 [suffix2 ...]]
  [VALIDATOR function]
  [DOC "cache documentation string"]
  [NO_CACHE]
  [REQUIRED|OPTIONAL]
  [NO_DEFAULT_PATH]
  [NO_PACKAGE_ROOT_PATH]
  [NO_CMAKE_PATH]
  [NO_CMAKE_ENVIRONMENT_PATH]
  [NO_SYSTEM_ENVIRONMENT_PATH]
  [NO_CMAKE_SYSTEM_PATH]
  [NO_CMAKE_INSTALL_PREFIX]
  [CMAKE_FIND_ROOT_PATH_BOTH |
  ONLY_CMAKE_FIND_ROOT_PATH |
  NO_CMAKE_FIND_ROOT_PATH]
)

Examples

Alpine-DAV/ascent src/cmake/thirdparty/SetupCaliper.cmake :20 

find_file(CALI_CONFIG_HEADER
          NAMES caliper-config.h
          PATHS ${CALIPER_DIR}
          PATH_SUFFIXES include/caliper
          NO_DEFAULT_PATH
          NO_CMAKE_ENVIRONMENT_PATH
          NO_CMAKE_PATH
          NO_SYSTEM_ENVIRONMENT_PATH
          NO_CMAKE_SYSTEM_PATH)

LLNL/axom src/cmake/thirdparty/SetupHDF5.cmake :133 

find_file(HDF5_SETTINGS_FILE
          NAMES libhdf5.settings
          PATHS ${HDF5_DIR}
          PATH_SUFFIXES lib share/cmake/hdf5
          NO_DEFAULT_PATH
          NO_CMAKE_ENVIRONMENT_PATH
          NO_CMAKE_PATH
          NO_SYSTEM_ENVIRONMENT_PATH
          NO_CMAKE_SYSTEM_PATH)

fluent/fluent-bit lib/wasm-micro-runtime-WAMR-2.4.1/samples/cmake/FindEMSCRIPTEN.cmake :16 

find_file(EMSCRIPTEN_VERSION_FILE
  NAMES emscripten-version.txt
  PATHS ${EMSCRIPTEN_HOME}/upstream/emscripten
  NO_DEFAULT_PATH
  NO_CMAKE_PATH
  NO_CMAKE_SYSTEM_PATH
  NO_CMAKE_FIND_ROOT_PATH
  REQUIRED
)