QLibrary Class

Documentation des fonctions membres

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

Construit une bibliothèque avec l'adresse parent.

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

Construit un objet bibliothèque avec l'adresse parent qui chargera la bibliothèque spécifiée par fileName.

Nous recommandons d'omettre le suffixe du fichier dans fileName, car QLibrary recherchera automatiquement le fichier avec le suffixe approprié en fonction de la plateforme, par exemple ".so" sous Unix, ".dylib" sous macOS et iOS, et ".dll" sous Windows. (Voir fileName.)

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

Construit un objet bibliothèque avec l'adresse parent qui chargera la bibliothèque spécifiée par fileName et le numéro de version complet version. Actuellement, le numéro de version est ignoré sous Windows.

Nous recommandons d'omettre le suffixe du fichier dans fileName, car QLibrary recherchera automatiquement le fichier avec le suffixe approprié en fonction de la plate-forme, par exemple ".so" sous Unix, ".dylib" sous macOS et iOS, et ".dll" sous Windows. (Voir fileName.)

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

Construit un objet bibliothèque avec l'adresse parent qui chargera la bibliothèque spécifiée par fileName et le numéro de version majeure verNum. Actuellement, le numéro de version est ignoré sous Windows.

Nous recommandons d'omettre le suffixe du fichier dans fileName, car QLibrary recherchera automatiquement le fichier avec le suffixe approprié en fonction de la plate-forme, par exemple ".so" sous Unix, ".dylib" sous macOS et iOS, et ".dll" sous Windows. (Voir fileName.)

[virtual noexcept] QLibrary::~QLibrary()

Détruit l'objet QLibrary.

À moins que unload() n'ait été appelé explicitement, la bibliothèque reste en mémoire jusqu'à ce que l'application se termine.

Voir aussi isLoaded() et unload().

QString QLibrary::errorString() const

Renvoie une chaîne de texte contenant la description de la dernière erreur survenue. Actuellement, errorString n'est défini que si load(), unload() ou resolve() échoue pour une raison quelconque.

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

Renvoie true si fileName a un suffixe valide pour une bibliothèque chargeable ; sinon, renvoie false.

Sous Unix, les numéros de version qui suivent sont ignorés.

bool QLibrary::isLoaded() const

Renvoie true si load() a réussi ; sinon, renvoie false.

Voir aussi load().

bool QLibrary::load()

Charge la bibliothèque et renvoie true si la bibliothèque a été chargée avec succès ; sinon, renvoie false. Étant donné que resolve() appelle toujours cette fonction avant de résoudre les symboles, il n'est pas nécessaire de l'appeler explicitement. Dans certaines situations, il est possible que vous souhaitiez que la bibliothèque soit chargée à l'avance, auquel cas vous utiliserez cette fonction.

Voir aussi unload().

QFunctionPointer QLibrary::resolve(const char *symbol)

Renvoie l'adresse du symbole exporté symbol. La bibliothèque est chargée si nécessaire. La fonction renvoie nullptr si le symbole n'a pas pu être résolu ou si la bibliothèque n'a pas pu être chargée.

Exemple :

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

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

Le symbole doit être exporté en tant que fonction C de la bibliothèque. Cela signifie que la fonction doit être enveloppée dans un extern "C" si la bibliothèque est compilée avec un compilateur C++. Sous Windows, vous devez également exporter explicitement la fonction de la DLL à l'aide de la directive du compilateur __declspec(dllexport), par exemple :

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

avec MY_EXPORT défini comme

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

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

Charge la bibliothèque fileName et renvoie l'adresse du symbole exporté symbol. Notez que fileName ne doit pas inclure le suffixe de fichier spécifique à la plate-forme ; (voir fileName). La bibliothèque reste chargée jusqu'à ce que l'application se termine.

La fonction renvoie nullptr si le symbole n'a pas pu être résolu ou si la bibliothèque n'a pas pu être chargée.

Voir également resolve().

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

Charge la bibliothèque fileName avec le numéro de version complète version et renvoie l'adresse du symbole exporté symbol. Notez que fileName ne doit pas inclure le suffixe de fichier spécifique à la plate-forme ; (voir fileName). La bibliothèque reste chargée jusqu'à ce que l'application se termine. version est ignoré sous Windows.

La fonction renvoie nullptr si le symbole n'a pas pu être résolu ou si la bibliothèque n'a pas pu être chargée.

Voir également resolve().

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

Charge la bibliothèque fileName avec le numéro de version majeure verNum et renvoie l'adresse du symbole exporté symbol. Notez que fileName ne doit pas inclure le suffixe de fichier spécifique à la plate-forme ; (voir fileName). La bibliothèque reste chargée jusqu'à ce que l'application se termine. verNum est ignoré sous Windows.

La fonction renvoie nullptr si le symbole n'a pas pu être résolu ou si la bibliothèque n'a pas pu être chargée.

Voir également resolve().

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

Définit la propriété fileName et le numéro de la version complète à fileName et version respectivement. Le paramètre version est ignoré sous Windows.

Voir aussi setFileName().

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

Définit la propriété fileName et le numéro de version majeure à fileName et versionNumber respectivement. La propriété versionNumber est ignorée sous Windows.

Voir aussi setFileName().

bool QLibrary::unload()

Décharge la bibliothèque et renvoie true si la bibliothèque a pu être déchargée ; sinon, elle renvoie false.

Cela se produit automatiquement à la fin de l'application, de sorte que vous ne devriez normalement pas avoir besoin d'appeler cette fonction.

Si d'autres instances de QLibrary utilisent la même bibliothèque, l'appel échouera et le déchargement n'aura lieu que lorsque toutes les instances auront appelé unload().

Notez que sur macOS, les bibliothèques dynamiques ne peuvent pas être déchargées. QLibrary::unload() renverra true, mais la bibliothèque restera chargée dans le processus.

Voir aussi resolve() et load().