QLibrary Class

メンバ関数ドキュメント

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

与えられたparent でライブラリを構築する。

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

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

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

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

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

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

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

fileName とメジャーバージョン番号verNum で指定されたライブラリをロードする、与えられたparent を持つライブラリオブジェクトを構築する。現在、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)

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

ライブラリfileName を完全なバージョン番号version でロードし、エクスポートされたシンボル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()も参照してください 。