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)

这是一个重载函数。

加载具有完整版本号version 的库fileName ，并返回导出符号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()。