简介
使用QLibraryi可以在程序运行时加载动态链接库。一个QLibrary的实例作用于一个单一的共享库上。QLibrary提
供了一种平台无关的方式访问库中的函数。可以在构建QLibrary的实例时将要加载的库文件传入,也可以在创建
实例后使用setFileName(0显式的设置要加载的文件名。当加载库文件时,QLibrary会搜索所有平台特定的库位
置,除非传入的文件名具有绝对路径。
如果传入的文件名具有绝对路径,那么会首先尝试加载该目录。如果该文件找不到,QLibrary会使用不同的平台
特定的文件前缀或后缀再次尝试,比如Unix和Mac平台的"ib"前缀,Unix平台的".so"后缀,Mac平台
的".dyib",windows平台的".dll"。如果文件名不是绝对路径,QLibrary会修改搜索顺序,首先尝试系统特定的
前缀和后缀,紧接着是指定的文件路径。
所以,基于QLibrary对库文件的搜索机制,我们推荐在传入库文件时只传入该库文件的基名,不写前缀或后缀。
这样一来,同一份代码可以在不同的操作系统上工作,并且该机制会保证进行最小次数的搜索。
该类中最重要的函数是Ioad(),该函数动态的加载库文件,isLoaded()可以用来检查库文件是否成功加载,而resolve(函数则用来解析库中的符号地址,主要是函数地址。并且,resolve()函数在库文件未被加载时会隐式的尝试加载它。多个QLibrary实例可以可以访问同一个库文件。因为,库文件一旦被加载,就会驻留在内存中直到
应用程序终止。当然,我们可以使用unload()函数来尝试卸载一个库文件,但是如果有其他的QLibrary实例正在
引用同一个库文件,unload()会调用失败,并且该库文件会在所以实例都调用了unload()后才被卸载。
QLibraryl库的典型用法是去解析一个库中的导出符号,并调用该符号表示的C函数。这被祢为“显式链接”,而
相对的“隐式链接”是在编译过程的链接阶段完成的。如下面的代码显示的那样,改代码先加载一个库,解析其
中的"ysymbol"符号,并在成功的情况下,调用该函数。如果由于某种原因出错了,例如库文件不存在或该符
号未被定义,那么相应的函数指针将被设为空,不会发生实际的调用:
QLibrary myLib("mylib");
typedef void (*MyPrototype)();
MyPrototype myFunction = (MyPrototype) myLib.resolve("mysymbol");
if (myFunction)
myFunction();
但该符号必须被导出为C函数。也就是说,如果该库是由C++编译器编译的,那么该函数必须被包在extern
"C"块中。并且在Vindows平台上,还需要使用dllexport宏来修饰该函数。
出于方便,该类还提供了一个静态的resolv)函数,我们可以使用该函数来解析并调用一个库中的方法,而不需
要先加载该库。如下代码所示:
typedef void (*MyPrototype)();
MyPrototype myFunction =
(MyPrototype) QLibrary::resolve("mylib", "mysymbol");
if (myFunction)
myFunction();
其实,除了静态的resolve()函数,该类还提供了一个静态的isLibrary()函数,该函数可以根据特定平台来判断
一个文件是否是可被加载的库。其所使用的规则如下:
下面,我们通过一个实例来简单使用一下该类。
生成DLL库示例
我们先使用QtCreator来写一个d工程,工程名为Add,在该d川中提供一个函数,完成两个数字的加法。代码如
下:
在add.h中声明函数数,如下:
#ifndef ADD_H
#define ADD_H
#include "add_global.h"
extern "C" ADDSHARED_EXPORT int MyAdd(int a, int b);
#endif // ADD_H
在add.cpp中声明函数,如下:
#include "add.h"
int MyAdd(int a, int b)
{
return a + b;
}
编译,生成DLL即可。
使用示例
我们接下来在建一个Qt控制台测试工程TestAdd。代码如下:
#include <QLibrary>
#include <QDebug>
int main(int argc, char *argv[])
{
QCoreApplication a(argc, argv);
QLibrary lib("Add");
if(!lib.load())
{
qDebug() << "load library failed";
qDebug() << lib.errorString();
return 0;
}
typedef int (*MyAdd)(int,int);
MyAdd myAdd = (MyAdd)lib.resolve("MyAdd");
if(myAdd)
{
qDebug() << "1 + 1 = " << myAdd(1, 1);
}
else
{
qDebug() << lib.errorString();
}
return a.exec();
}