本文主要是介绍CMake 脚本命令(Scripting Commands)之find_library,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!
find_library
find_library 一般直接去查找依赖库文件,和find_package 不一样,find_package 找的是 .cmake 文件,而find_library 直接找 .so 或者 .a 文件。和find_path 一样,命令的执行结果会默认缓存到 CMakeCache.txt 中。
(1) 格式
find_library (<VAR>name | NAMES name1 [name2 ...] [NAMES_PER_DIR][HINTS [path | ENV var]... ][PATHS [path | ENV var]... ][NO_CACHE][REQUIRED]
)
命令说明
该命令用于查找 library 。创建一个高速缓存条目,或者如果指定了 NO_CACHE
,则创建一个普通变量,以 <VAR>
命名,以存储该命令的结果。
如果找到 library ,结果将存储在变量中,并且不会重复搜索,除非清除变量。
如果未找到任何内容,结果将为 <VAR>-NOTFOUND
。
选项解析:
<VAR>: 是存储库路径的变量名
name: 后面是要查找的库的名称
NAMES: 当为 NAMES
选项指定多个值时,此命令默认情况下将一次考虑一个名称并在每个目录中搜索该名称。 NAMES_PER_DIR
选项告诉该命令一次考虑一个目录并搜索其中的所有名称
HINTS | PATHS: HINTS,先搜索指定路径,后搜索系统路径 ;PATHS,先搜索系统路径,后搜索指定路径
NO_CACHE:搜索结果将存储在普通变量中而不是缓存条目(即CMakeCache.txt)中 REQUIRED:如果没有找到指定库文件,就出发错误提示,变量会设为 -NOTFOUND
执行结果:
查找成功时,会向变量中添加成功找到头文件的库文件(包含完整路径),如果在某个路径下查找多个头文件,只要查找到多个头文件中的某一个,也算执行成功。
(2) 举例
unset(LIBS CACHE) # 清空变量LIB_DIR
find_library(LIBSNAMES libopencv_core.so # 前缀+库名+后缀HINTS /home/rookie/toolchain/opencv-3.4.10/build/lib
)
message("${LIBS}") # /home/rookie/toolchain/opencv-3.4.10/build/lib/libopencv_core.sounset(LIBS CACHE) # 清空变量LIB_DIR
find_library(LIBSNAMES opencv_highgui # 只有库名HINTS /home/rookie/toolchain/opencv-3.4.10/build/lib
)
message("${LIBS}") # /home/rookie/toolchain/opencv-3.4.10/build/lib/libopencv_highgui.so
# 查找并存储名为 MyLibrary 的库
find_library(MY_LIBRARY MyLibrary)# 如果找到,则打印库的完整路径
if(MY_LIBRARY)message("Library found at: ${MY_LIBRARY}")
else()message("Library not found")
endif()
这篇关于CMake 脚本命令(Scripting Commands)之find_library的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!