QLibrary类

成员函数文档

[显式] QLibrary::QLibrary(QObject *parent = nullptr)

使用给定的 parent 构造库。

[显式] QLibrary::QLibrary(const QString &fileName, QObject *parent = nullptr)

使用给定的 parent 和由 fileName 指定的库对象构造库。

我们建议在 fileName 中省略文件的扩展名，因为 QLibrary 会根据平台自动查找具有适当后缀的文件，例如 Unix 上的 ".so"，macOS 和 iOS 上的 ".dylib"，以及 Windows 上的 ".dll"。 （参见 fileName。）

[显式] QLibrary::QLibrary(const QString &fileName, int verNum, QObject *parent = nullptr)

使用给定的 parent 和由 fileName 指定的库，并加载主版本号 verNum 的库对象。目前，在 Windows 上版本号被忽略。

我们建议在 fileName 中省略文件的扩展名，因为 QLibrary 会根据平台自动查找具有适当后缀的文件，例如 Unix 上的 ".so"，macOS 和 iOS 上的 ".dylib"，以及 Windows 上的 ".dll"。 （参见 fileName。）

[显式] QLibrary::QLibrary(const QString &fileName, const QString &version, QObject *parent = nullptr)

使用给定的 parent 和由 fileName 指定的库，并加载完整版本号 version 的库对象。目前，在 Windows 上版本号被忽略。

我们建议在 fileName 中省略文件的扩展名，因为 QLibrary 会根据平台自动查找具有适当后缀的文件，例如 Unix 上的 ".so"，macOS 和 iOS 上的 ".dylib"，以及 Windows 上的 ".dll"。 （参见 fileName。）

[虚拟 noexcept] QLibrary::~QLibrary()

销毁 QLibrary 对象。

除非显式调用 unload()，否则库将保留在内存中，直到应用程序终止。

另请参阅isLoaded() 和 unload()。

QString QLibrary::errorString() const

返回描述最后发生的错误文本字符串。目前，仅在 load()，unload() 或 resolve() 由于某些原因失败时，errorString 才会被设置。

[静态] bool QLibrary::isLibrary(const QString &fileName)

如果 fileName 是可加载库的有效后缀，则返回 true；否则返回 false。

Unix 中的尾随版本号被忽略。

bool QLibrary::isLoaded() const

如果 load() 成功，则返回 true；否则返回 false。

另请参阅：load

bool QLibrary::load()

加载库并返回 true 表示库已成功加载；否则返回 false。由于 resolve () 总是在解决任何符号之前调用此函数，因此通常不需要显式调用它。在某些情况下，可能需要提前加载库，这种情况下可以使用此函数。

另请参阅：unload ()。

QFunctionPointer QLibrary::resolve(const char *symbol)

返回导出符号 symbol 的地址。如果需要，则加载库。如果无法解析符号或无法加载库，则函数返回 nullptr。

示例

typedef int (*AvgFunction)(int, int);

AvgFunction avg = (AvgFunction) library->resolve("avg");
if (avg)
    return avg(5, 8);
else
    return -1;

符号必须作为 C 函数从库中导出。这意味着如果库是用 C++ 编译器编译的，则必须在函数周围使用 extern "C"。在 Windows 上，还必须使用 __declspec(dllexport) 编译器指令显式从 DLL 中导出函数，例如

extern "C" MY_EXPORT int avg(int a, int b)
{
    return (a + b) / 2;
}

当 MY_EXPORT 定义为

#ifdef Q_OS_WIN
#define MY_EXPORT __declspec(dllexport)
#else
#define MY_EXPORT
#endif

[静态] QFunctionPointer QLibrary::resolve(const QString &fileName, const char *symbol)

这是一个重载函数。

加载库 fileName 并返回导出符号 symbol 的地址。请注意，fileName 不应包含特定平台的文件后缀；（请参阅 fileName）。库将在应用程序退出之前保持加载状态。

如果无法解析符号或无法加载库，则函数返回 nullptr。

另请参阅：resolve ()。

[静态] QFunctionPointer QLibrary::resolve(const QString &fileName, int verNum, const char *symbol)

这是一个重载函数。

加载名为 fileName 的库，主版本号为 verNum，并返回导出符号 symbol 的地址。注意 fileName 应当不包含平台特定的文件后缀；（见 fileName）。库将在应用程序退出之前保持加载状态。在 Windows 上忽略 verNum。

如果无法解析符号或无法加载库，则函数返回 nullptr。

另请参阅：resolve ()。

[静态] QFunctionPointer QLibrary::resolve(const QString &fileName, const QString &version, const char *symbol)

这是一个重载函数。

加载带有完整版本号 version 的库 fileName 并返回导出符号 symbol 的地址。注意 fileName 应当不包含平台特定的文件后缀；（见 fileName）。库将在应用程序退出之前保持加载状态。在 Windows 上忽略 version。

如果无法解析符号或无法加载库，则函数返回 nullptr。

另请参阅：resolve ()。

void QLibrary::setFileNameAndVersion(const QString &fileName, int versionNumber)

设置 fileName 属性和主版本号分别为 fileName 和 versionNumber。在 Windows 上忽略 versionNumber。

另请参阅 setFileName。

void QLibrary::setFileNameAndVersion(const QString &fileName, const QString &version)

设置 fileName 属性和完整版本号分别为 fileName 和 version。在 Windows 上忽略 version 参数。

另请参阅 setFileName。

bool QLibrary::unload()

卸载库，如果库能够卸载则返回 true，否则返回 false。

在应用程序终止时此操作会自动发生，因此通常不需要调用此函数。

如果其他 QLibrary 实例正在使用同一库，则调用将失败，卸载只会在每个实例都已调用 unload() 的时候发生。

请注意，在 macOS 上，动态库不能卸载。QLibrary::unload() 将返回 true，但库仍然保持在进程中加载。

另请参阅 resolve() 和 load。