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

chipsalliance/Surelog cmake/modules/FindANTLR.cmake :14 

find_file(ANTLR_JAR_LOCATION
            NAMES antlr-4.12.0-complete.jar antlr-4.13.0-complete.jar antlr-4.13.1-complete.jar antlr.jar antlr4.jar antlr-4.jar 
            HINTS /usr /usr/local /usr/local/share /usr/local/share/java /usr/local/lib/ /usr/share /usr/share/java /usr/local/Homebrew ~/homebrew /usr/local/homebrew/Cellar /opt/homebrew/Cellar
            PATH_SUFFIXES antlr 4.12.0 4.13.0 4.13.1 antlr/4.12.0 antlr/4.13.0 antlr/4.13.1 
            NO_CMAKE_SYSTEM_PATH
            NO_SYSTEM_ENVIRONMENT_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)

LLNL/conduit 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)

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
)

bytecodealliance/wasm-micro-runtime 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
)