QLibrary Class

Dokumentation zu den Member-Funktionen

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

Erstellt eine Bibliothek mit dem angegebenen „ parent “.

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

Erstellt ein Bibliotheksobjekt mit dem angegebenen ` parent `, das die durch ` fileName` angegebene Bibliothek lädt.

Wir empfehlen, die Dateiendung in ` fileName` wegzulassen, da QLibrary automatisch nach der Datei mit der für die jeweilige Plattform passenden Endung sucht, z. B. „.so“ unter Unix, „.dylib“ unter macOS und iOS sowie „.dll“ unter Windows. (Siehe fileName.)

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

Erstellt ein Bibliotheksobjekt mit dem angegebenen „ parent “, das die durch „ fileName “ angegebene Bibliothek sowie die vollständige Versionsnummer „ version “ lädt. Derzeit wird die Versionsnummer unter Windows ignoriert.

Wir empfehlen, die Dateiendung in fileName wegzulassen, da QLibrary automatisch nach der Datei mit der plattformgerechten Endung sucht, z. B. „.so“ unter Unix, „.dylib“ unter macOS und iOS sowie „.dll“ unter Windows. (Siehe fileName.)

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

Erstellt ein Bibliotheksobjekt mit dem angegebenen „ parent “, das die durch „ fileName “ angegebene Bibliothek mit der Hauptversionsnummer „ verNum “ lädt. Derzeit wird die Versionsnummer unter Windows ignoriert.

Wir empfehlen, die Dateiendung in ` fileName` wegzulassen, da QLibrary automatisch nach der Datei mit der für die jeweilige Plattform passenden Endung sucht, z. B. „.so“ unter Unix, „.dylib“ unter macOS und iOS sowie „.dll“ unter Windows. (Siehe fileName.)

[virtual noexcept] QLibrary::~QLibrary()

Löscht das QLibrary -Objekt.

Sofern ` unload()` nicht explizit aufgerufen wurde, verbleibt die Bibliothek im Speicher, bis die Anwendung beendet wird.

Siehe auch ` isLoaded()` und ` unload()`.

QString QLibrary::errorString() const

Gibt eine Textzeichenfolge mit der Beschreibung des zuletzt aufgetretenen Fehlers zurück. Derzeit wird „errorString“ nur gesetzt, wenn „ load()“, „ unload()“ oder „ resolve()“ aus irgendeinem Grund fehlschlägt.

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

Gibt „ true “ zurück, wenn „ fileName “ ein gültiges Suffix für eine ladbare Bibliothek enthält; andernfalls wird „ false “ zurückgegeben.

Anhängende Versionsnummern unter Unix werden ignoriert.

bool QLibrary::isLoaded() const

Gibt „ true “ zurück, wenn „ load()“ erfolgreich war; andernfalls wird „ false “ zurückgegeben.

Siehe auch ` load()`.

bool QLibrary::load()

Lädt die Bibliothek und gibt „ true “ zurück, wenn die Bibliothek erfolgreich geladen wurde; andernfalls wird „ false “ zurückgegeben. Da „ resolve()“ diese Funktion immer aufruft, bevor Symbole aufgelöst werden, ist es nicht notwendig, sie explizit aufzurufen. In manchen Situationen möchten Sie möglicherweise, dass die Bibliothek im Voraus geladen wird; in diesem Fall würden Sie diese Funktion verwenden.

Siehe auch ` unload()`.

QFunctionPointer QLibrary::resolve(const char *symbol)

Gibt die Adresse des exportierten Symbols „ symbol “ zurück. Die Bibliothek wird bei Bedarf geladen. Die Funktion gibt „ nullptr “ zurück, wenn das Symbol nicht aufgelöst werden konnte oder die Bibliothek nicht geladen werden konnte.

Beispiel:

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

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

Das Symbol muss als C-Funktion aus der Bibliothek exportiert werden. Das bedeutet, dass die Funktion in eine ` extern "C" ` eingeschlossen werden muss, wenn die Bibliothek mit einem C++-Compiler kompiliert wird. Unter Windows müssen Sie die Funktion außerdem explizit mithilfe der Compiler-Direktive ` __declspec(dllexport) ` aus der DLL exportieren, zum Beispiel:

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

wobei ` MY_EXPORT ` wie folgt definiert ist:

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

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

Lädt die Bibliothek „ fileName “ und gibt die Adresse des exportierten Symbols „ symbol “ zurück. Beachten Sie, dass „ fileName “ kein plattformspezifisches Dateiendung enthalten darf (siehe fileName). Die Bibliothek bleibt geladen, bis die Anwendung beendet wird.

Die Funktion gibt nullptr zurück, wenn das Symbol nicht aufgelöst werden konnte oder die Bibliothek nicht geladen werden konnte.

Siehe auch resolve().

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

Lädt die Bibliothek „ fileName “ mit der vollständigen Versionsnummer „ version “ und gibt die Adresse des exportierten Symbols „ symbol “ zurück. Beachten Sie, dass „ fileName “ keine plattformspezifische Dateiendung enthalten sollte (siehe fileName). Die Bibliothek bleibt geladen, bis die Anwendung beendet wird. „ version “ wird unter Windows ignoriert.

Die Funktion gibt „ nullptr “ zurück, wenn das Symbol nicht aufgelöst oder die Bibliothek nicht geladen werden konnte.

Siehe auch resolve().

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

Lädt die Bibliothek „ fileName “ mit der Hauptversionsnummer „ verNum “ und gibt die Adresse des exportierten Symbols „ symbol “ zurück. Beachten Sie, dass „ fileName “ keine plattformspezifische Dateiendung enthalten sollte (siehe fileName). Die Bibliothek bleibt geladen, bis die Anwendung beendet wird. „ verNum “ wird unter Windows ignoriert.

Die Funktion gibt ` nullptr ` zurück, wenn das Symbol nicht aufgelöst oder die Bibliothek nicht geladen werden konnte.

Siehe auch ` resolve()`.

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

Setzt die Eigenschaft „ fileName “ und die vollständige Versionsnummer auf „ fileName “ bzw. „ version “. Der Parameter „ version “ wird unter Windows ignoriert.

Siehe auch setFileName().

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

Setzt die Eigenschaft „ fileName “ sowie die Hauptversionsnummer auf „ fileName “ bzw. „ versionNumber “. Die Eigenschaft „ versionNumber “ wird unter Windows ignoriert.

Siehe auch setFileName().

bool QLibrary::unload()

Lädt die Bibliothek ab und gibt „ true “ zurück, wenn die Bibliothek erfolgreich abgeladen werden konnte; andernfalls wird „ false “ zurückgegeben.

Dies geschieht automatisch beim Beenden der Anwendung, sodass Sie diese Funktion normalerweise nicht aufrufen müssen.

Wenn andere Instanzen von ` QLibrary ` dieselbe Bibliothek verwenden, schlägt der Aufruf fehl, und das Entladen erfolgt erst, wenn jede Instanz `unload()` aufgerufen hat.

Beachten Sie, dass unter macOS dynamische Bibliotheken nicht entladen werden können. `QLibrary::unload()` gibt ` true` zurück, die Bibliothek bleibt jedoch im Prozess geladen.

Siehe auch ` resolve()` und ` load()`.