创建一个新的cpp文件后,定义一个函数
我们希望这个函数是可以被多个程序调用的,而不是直接输入在程序中进行编译。在C++程序中,不是所有代码都会被编译成可执行文件,只有main函数所在的程序才可以生成可执行文件。而这个库是通过上一节中的配置文件CMakeLists.txt文件中,通过add_library
命令调用的,命令格式如下:
add_library(库名 文件名)
当使用add_library
命令时,我们通过命令告诉CMake我们想要创建一个库。这个库可以是由一个或多个源文件编译而成的静态库或动态库。
例如,如果你有一个名为mylib
的库,并且想要生成一个静态库(.a文件),你的CMakeLists.txt文件需要加入如下语句:
add_library(mylib lib.cpp)
这里,CMake将会编译lib.cpp
文件并生成一个名为libmylib.a
的静态库文件。
下面进行实操,如下图,我们把第一张图中的函数整体打包命名为一个叫Hello的库
随后进行编译
编译后我们发现生成了一个多余的libHello.a的文件,.a
文件是一个静态库文件,它包含了编译后的函数和对象的二进制代码。这个文件对我们之前所写的函数进行了一个“打包”,也就是我们得到的库,有了这个文件就可以调用我们之前所写的函数了,
然而,仅仅有.a
文件是不够的,因为我们还需要知道库中包含哪些函数以及如何正确地调用它们。这就引入了头文件(.h
文件)的概念。
头文件的作用是声明库中公开的函数和类的接口,它为开发者提供了必要的函数原型、类定义和其他相关的声明信息。当你想要使用静态库中的某个函数时,你需要在源代码中包含对应的头文件,这样编译器就能够理解函数的签名(即函数的返回类型、名称和参数类型),并确保你在源代码中对函数的调用是正确的。
为了顺利调用函数,还需要一个Hello.h的头文件来告诉程序库里面有这样一个函数。
假设库中有一个函数void my_function()
,头文件(mylib.h)大体格式如下:
#ifndef MYLIB_H
#define MYLIB_H
void my_function();
#endif // MYLIB_H
或者(与上面的表达意思一致)
#pragma once
void my_function();
同时,我们的CMakeLists.txt需要确保主程序链接到库:
add_executable(myapp main.cpp)
target_link_libraries(myapp mylib)
这里,add_executable
创建了一个名为myapp
的可执行文件,target_link_libraries
告诉CMake在链接时需要包含mylib
库。
拓展:#pragma once 与 #ifndef 特性对比
特性 | #pragma once | #ifndef |
---|---|---|
标准性 | 非标准 | 标准 |
跨编译器 | 不一定支持 | 广泛支持 |
实现机制 | 编译器层面 | 预处理器 |
防止重复 | 单一编译单元 | 全局 |
宏冲突风险 | 无 | 有 |
——————————————————————
这个头文件声明了my_function
函数的存在,但没有定义它。函数的定义通常在库的源文件(如lib.cpp
)中给出,在我们的操作中就是libHello.cpp(第一个图)。在修改完配置文件后,通过vim Hello.h创建一个文件,按上面的格式要求编辑头文件。
可以通过less命令查看并浏览文件内容,按q退出。至此,libHello.cpp和Hello.h构成了一个完整的库,可以进行调用,新建一个usehello.cpp文件并调用该头文件以及其包含的函数,程序如下。
然后需要创建可执行文件并确保CMakeLists.txt主程序链接到库
编译:
打开build文件夹后,文件如下,运行可执行文件,运行成功!
步骤总结:
1.新建一个.cpp文件并定义一个函数:
创建一个源文件,例如mylib.cpp
,并在其中定义一个函数。
2.在配置文件CMakeLists.txt中通过add_library命令创建一个库:
编辑CMakeLists.txt
文件,使用add_library
命令添加你的库,指定库的名称和源文件。
3.编译生成.a文件:
运行CMake来配置项目,并生成构建系统,然后使用构建系统编译库,生成库文件(如.a
或.so
)。
4.新建一个头文件.h:
创建一个头文件,例如mylib.h
,并在其中声明库中要公开的函数。
5.将CMakeLists.txt链接到库:
在CMakeLists.txt
中,使用target_link_libraries
命令将你的可执行文件或库与新建的库链接起来。(假设你已经有一个可以利用该函数的cpp文件并在配置文件中配置完成)
6.编译并运行:
再次运行CMake和构建系统,编译整个项目,包括使用了新库的文件。
运行生成的可执行文件,验证函数是否按预期工作。