QLibrary Class

成员函数文档

[explicit] QLibrary::QLibrary(QObject *parent = nullptr)

使用给定的parent 构建一个库。

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

使用给定的parent 构建一个库对象，该对象将加载由fileName 指定的库。

建议在fileName 中省略文件后缀，因为QLibrary会根据平台自动查找具有相应后缀的文件，例如在Unix系统上为“.so”，在macOS和iOS系统上为“.dylib”，在Windows系统上为“.dll”。（参见fileName 。）

[explicit] 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 。）

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

根据给定的parent 构建一个库对象，该对象将加载由fileName 指定的库，其主版本号为verNum 。目前，在Windows系统上会忽略版本号。

建议在fileName 中省略文件后缀，因为QLibrary会根据平台自动查找具有相应后缀的文件，例如在Unix系统上为“.so”，在macOS和iOS系统上为“.dylib”，在Windows系统上为“.dll”。（参见fileName 。）

[virtual noexcept] QLibrary::~QLibrary()

销毁QLibrary 对象。

除非显式调用了unload()，否则该库将一直驻留在内存中，直至应用程序终止。

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

QString QLibrary::errorString() const

返回一个文本字符串，其中包含最近发生的错误的描述。目前，只有当load()、unload() 或resolve() 因某种原因失败时，errorString 才会被设置。

[static] 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

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

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

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

另请参阅 resolve()。

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

加载库fileName （完整版本号为version ），并返回导出符号symbol 的地址。请注意，fileName 不应包含平台特有的文件后缀；（参见fileName ）。该库将保持加载状态，直至应用程序退出。在Windows系统上，version 将被忽略。

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

另请参见 resolve()。

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

加载主版本号为verNum 的库fileName ，并返回导出符号symbol 的地址。请注意，fileName 不应包含平台特有的文件后缀；（参见fileName ）。该库将保持加载状态，直至应用程序退出。在Windows系统上，verNum 将被忽略。

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

另请参阅 resolve()。

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

将fileName 属性与完整版本号分别设置为fileName 和version 。在Windows系统上，version 参数将被忽略。

另请参阅 setFileName()。

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

将fileName 属性与主版本号分别设置为fileName 和versionNumber 。在Windows系统上，versionNumber 将被忽略。

另请参阅 setFileName()。

bool QLibrary::unload()

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

应用程序终止时会自动执行此操作，因此通常无需调用此函数。

如果其他 `QLibrary ` 实例正在使用同一库，则调用将失败，只有当所有实例都已调用 `unload()` 后，才会发生卸载。

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

另请参阅 resolve() 和load()。