QLibrary Class

メンバ関数ドキュメント

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

指定されたparent でライブラリを構築します。

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

fileName で指定されたライブラリをロードする、指定されたparent を持つライブラリ・オブジェクトを構築します。

fileNameQLibrary は、プラットフォームに応じて適切な接尾辞を持つファイルを自動的に探します（Unix では ".so"、macOS および iOS では ".dylib"、Windows では ".dll"）。(fileName を参照）。

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

与えられたparent でライブラリオブジェクトを構築し、fileName と完全なバージョン番号version で指定されたライブラリをロードする。現在、Windowsではバージョン番号は無視されます。

fileNameQLibrary は、プラットフォームに応じて適切な接尾辞を持つファイルを自動的に探します。例えば、Unixでは".so"、macOSとiOSでは".dylib"、Windowsでは".dll "です。(fileName を参照）。

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

与えられたparent でライブラリオブジェクトを構築し、fileName とメジャーバージョン番号verNum で指定されたライブラリをロードする。現在、Windowsではバージョン番号は無視されます。

fileNameQLibrary は、プラットフォームに応じて適切な接尾辞を持つファイルを自動的に探します。例えば、Unix では ".so"、macOS と iOS では ".dylib"、Windows では ".dll" です。(fileName を参照）。

[virtual noexcept] QLibrary::~QLibrary()

QLibrary オブジェクトを破棄する。

unload() が明示的に呼び出されない限り、アプリケーション が終了するまでライブラリはメモリ上に残る。

isLoaded() およびunload()も参照 。

QString QLibrary::errorString() const

最後に発生したエラーの説明をテキスト文字列で返します。現在のところ、errorString が設定されるのは、何らかの理由でload()、unload()、またはresolve() が失敗した場合のみである。

[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 を参照）。version は Windows では無視されます。

シンボルを解決できなかった場合、またはライブラリをロードできなかった場合、この関数はnullptr を返します。

resolve()も参照 。

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

これはオーバーロードされた関数です。

ライブラリfileName をメジャー・バージョン番号verNum でロードし、エクスポートされたシンボルsymbol のアドレスを返します。fileName には、プラットフォーム固有のファイル接尾辞; （fileName を参照）を含めてはならないことに注意。verNum は Windows では無視されます。

シンボルを解決できなかった場合、またはライブラリをロードできなかった場合、この関数はnullptr を返します。

resolve()も参照 。

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

fileName プロパティと完全なバージョン番号を、それぞれfileName とversion に設定します。version パラメータは Windows では無視されます。

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()も参照してください 。