QLibrary Class

Dokumentation der Mitgliedsfunktionen

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

Konstruiert eine Bibliothek mit der angegebenen parent.

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

Konstruiert ein Library-Objekt mit der angegebenen parent, das die durch fileName angegebene Library lädt.

Wir empfehlen, das Suffix der Datei in fileName wegzulassen, da QLibrary automatisch nach der Datei mit dem entsprechenden Suffix in Übereinstimmung mit der Plattform sucht, z.B. ".so" unter Unix, ".dylib" unter macOS und iOS und ".dll" unter Windows. (Siehe fileName.)

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

Konstruiert ein Bibliotheksobjekt mit der angegebenen parent, das die durch fileName angegebene Bibliothek und die vollständige Versionsnummer version lädt. Derzeit wird die Versionsnummer unter Windows ignoriert.

Wir empfehlen, das Suffix der Datei in fileName wegzulassen, da QLibrary automatisch nach der Datei mit dem entsprechenden Suffix in Übereinstimmung mit der Plattform sucht, z. B. ".so" unter Unix, ".dylib" unter macOS und iOS und ".dll" unter Windows. (Siehe fileName.)

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

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

Wir empfehlen, das Suffix der Datei in fileName wegzulassen, da QLibrary automatisch nach der Datei mit dem entsprechenden Suffix in Übereinstimmung mit der Plattform sucht, z.B. ".so" unter Unix, ".dylib" unter macOS und iOS und ".dll" unter Windows. (Siehe fileName.)

[virtual noexcept] QLibrary::~QLibrary()

Zerstört das Objekt QLibrary.

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

Siehe auch isLoaded() und unload().

QString QLibrary::errorString() const

Gibt einen Textstring mit der Beschreibung des letzten 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 hat; andernfalls wird false zurückgegeben.

Nachfolgende 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 irgendwelche Symbole aufgelöst werden, ist es nicht notwendig, sie explizit aufzurufen. In manchen Situationen möchten Sie vielleicht, 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. Falls erforderlich, wird die Bibliothek geladen. Die Funktion gibt nullptr zurück, wenn das Symbol nicht aufgelöst werden konnte oder wenn 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 ein extern "C" eingeschlossen werden muss, wenn die Bibliothek mit einem C++-Compiler kompiliert wurde. Unter Windows müssen Sie die Funktion auch explizit aus der DLL exportieren, indem Sie z. B. die Compiler-Direktive __declspec(dllexport) verwenden:

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

mit MY_EXPORT definiert als

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

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

Dies ist eine überladene Funktion.

Lädt die Bibliothek fileName und gibt die Adresse des exportierten Symbols symbol zurück. Beachten Sie, dass fileName nicht das plattformspezifische Dateisuffix enthalten sollte; (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 wenn die Bibliothek nicht geladen werden konnte.

Siehe auch resolve().

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

Dies ist eine überladene Funktion.

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 nicht das plattformspezifische Dateisuffix 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 werden konnte oder wenn die Bibliothek nicht geladen werden konnte.

Siehe auch resolve().

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

Dies ist eine überladene Funktion.

Lädt die Bibliothek fileName mit der Hauptversionsnummer verNum und gibt die Adresse des exportierten Symbols symbol zurück. Beachten Sie, dass fileName nicht das plattformspezifische Dateisuffix 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 werden konnte oder wenn 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 und die Hauptversionsnummer auf fileName bzw. versionNumber. Die Eigenschaft versionNumber wird unter Windows ignoriert.

Siehe auch setFileName().

bool QLibrary::unload()

Entlädt die Bibliothek und gibt true zurück, wenn die Bibliothek entladen werden konnte; andernfalls wird false zurückgegeben.

Dies geschieht automatisch beim Beenden der Anwendung, so dass 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() wird true zurückgeben, aber die Bibliothek bleibt in den Prozess geladen.

Siehe auch resolve() und load().