find_file
find_file (<VAR> name1 [path1 path2 ...])
find_file (
<VAR>
name | NAMES name1 [name2 ...]
[HINTS [path | ENV var]... ]
[PATHS [path | ENV var]... ]
[PATH_SUFFIXES suffix1 [suffix2 ...]]
[DOC "cache documentation string"]
[NO_CACHE]
[REQUIRED]
[NO_DEFAULT_PATH]
[NO_PACKAGE_ROOT_PATH]
[NO_CMAKE_PATH]
[NO_CMAKE_ENVIRONMENT_PATH]
[NO_SYSTEM_ENVIRONMENT_PATH]
[NO_CMAKE_SYSTEM_PATH]
[CMAKE_FIND_ROOT_PATH_BOTH |
ONLY_CMAKE_FIND_ROOT_PATH |
NO_CMAKE_FIND_ROOT_PATH]
)
- 该命令用于查找指定文件的完整路径。
- 创建一个名为< VAR >的缓存条目(如果指定了NO_CACHE,则是一个普通变量)来存储此命令的结果。
- 如果找到文件的完整路径,则结果存储在变量中,并且搜索不会重复,除非该变量被清除。
- 如果没有找到,结果将是< VAR >-NOTFOUND。
选项包括:
- NAMES
- 为文件的完整路径指定一个或多个可能的名称。
- 当使用此方法指定带有或不带有版本后缀的名称时,我们建议首先指定未版本控制的名称,以便在发行版提供的包之前找到本地构建的包。
- HINTS, PATHS
- 除默认位置外,指定要搜索的目录。
- ENV var子选项从系统环境变量中读取路径。
- PATH_SUFFIXES
- 在每个目录位置下面指定要检查的其他子目录。
- DOC:
- 指定< VAR>缓存项的文档字符串。
- NO_CACHE
- 3.21新版功能。
- 搜索结果将存储在一个普通变量中,而不是缓存项中。
- 注意,如果在调用之前已经设置了变量(作为普通变量或缓存变量),则不会进行搜索。
- 警告:应该谨慎使用此选项,因为它可能会大大增加重复配置步骤的成本。
- REQUIRED
- 3.18新版功能。
- 如果没有找到任何东西,则停止处理并给出错误消息,否则下次用相同的变量调用find_file时将再次尝试搜索。
- NO_DEFAULT_PATH :
- 如果指定了NO_DEFAULT_PATH,则不会向搜索添加其他路径。
- 如果没有指定NO_DEFAULT_PATH,搜索过程如下:
find_library
find_library (<VAR> name1 [path1 path2 ...])
find_library (
<VAR>
name | NAMES name1 [name2 ...] [NAMES_PER_DIR]
[HINTS [path | ENV var]... ]
[PATHS [path | ENV var]... ]
[PATH_SUFFIXES suffix1 [suffix2 ...]]
[DOC "cache documentation string"]
[NO_CACHE]
[REQUIRED]
[NO_DEFAULT_PATH]
[NO_PACKAGE_ROOT_PATH]
[NO_CMAKE_PATH]
[NO_CMAKE_ENVIRONMENT_PATH]
[NO_SYSTEM_ENVIRONMENT_PATH]
[NO_CMAKE_SYSTEM_PATH]
[CMAKE_FIND_ROOT_PATH_BOTH |
ONLY_CMAKE_FIND_ROOT_PATH |
NO_CMAKE_FIND_ROOT_PATH]
)
此命令用于查找库。创建一个名为< VAR >的缓存条目(如果指定了NO_CACHE,则是一个普通变量)来存储此命令的结果。如果找到库,则结果存储在变量中,并且搜索不会重复,除非该变量被清除。如果没有找到,结果将是< VAR >-NOTFOUND。
选项包括:
- NAMES
- 为库指定一个或多个可能的名称。
- 当使用此方法指定带有或不带有版本后缀的名称时,我们建议首先指定未版本控制的名称,以便在发行版提供的包之前找到本地构建的包
find_path
find_path (<VAR> name1 [path1 path2 ...])
find_path (
<VAR>
name | NAMES name1 [name2 ...]
[HINTS [path | ENV var]... ]
[PATHS [path | ENV var]... ]
[PATH_SUFFIXES suffix1 [suffix2 ...]]
[DOC "cache documentation string"]
[NO_CACHE]
[REQUIRED]
[NO_DEFAULT_PATH]
[NO_PACKAGE_ROOT_PATH]
[NO_CMAKE_PATH]
[NO_CMAKE_ENVIRONMENT_PATH]
[NO_SYSTEM_ENVIRONMENT_PATH]
[NO_CMAKE_SYSTEM_PATH]
[CMAKE_FIND_ROOT_PATH_BOTH |
ONLY_CMAKE_FIND_ROOT_PATH |
NO_CMAKE_FIND_ROOT_PATH]
)
该命令用于查找包含命名文件的目录。创建一个名为< VAR >的缓存条目(如果指定了NO_CACHE,则是一个普通变量)来存储此命令的结果。如果找到目录中的文件,结果将存储在变量中,并且搜索将不会重复,除非该变量被清除。如果没有找到,结果将是< VAR >-NOTFOUND。
find_program
find_program (<VAR> name1 [path1 path2 ...])
find_program (
<VAR>
name | NAMES name1 [name2 ...] [NAMES_PER_DIR]
[HINTS [path | ENV var]... ]
[PATHS [path | ENV var]... ]
[PATH_SUFFIXES suffix1 [suffix2 ...]]
[DOC "cache documentation string"]
[NO_CACHE]
[REQUIRED]
[NO_DEFAULT_PATH]
[NO_PACKAGE_ROOT_PATH]
[NO_CMAKE_PATH]
[NO_CMAKE_ENVIRONMENT_PATH]
[NO_SYSTEM_ENVIRONMENT_PATH]
[NO_CMAKE_SYSTEM_PATH]
[CMAKE_FIND_ROOT_PATH_BOTH |
ONLY_CMAKE_FIND_ROOT_PATH |
NO_CMAKE_FIND_ROOT_PATH]
)
该命令用于查找程序。创建一个名为< VAR >的缓存条目(如果指定了NO_CACHE,则是一个普通变量)来存储此命令的结果。如果找到该程序,则结果存储在该变量中,并且搜索不会重复,除非该变量被清除。如果没有找到,结果将是< VAR >-NOTFOUND。