QLibrary Class

Documentation des fonctions membres

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

Crée une bibliothèque à partir de l'parent on fournie.

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

Crée un objet de bibliothèque à partir de l'parent fournie, qui chargera la bibliothèque spécifiée par fileName.

Nous recommandons d'omettre l'extension du fichier dans fileName, car QLibrary recherchera automatiquement le fichier avec l'extension appropriée 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)

Crée un objet de bibliothèque avec l'parent fournie, 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 l'extension du fichier dans fileName, car QLibrary recherchera automatiquement le fichier avec l'extension appropriée 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, int verNum, QObject *parent = nullptr)

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

Nous recommandons d’omettre l’extension du fichier dans fileName, car QLibrary recherchera automatiquement le fichier avec l’extension appropriée en fonction de la plateforme, 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 la fonction unload() n'ait été appelée explicitement, la bibliothèque reste en mémoire jusqu'à la fermeture de l'application.

Voir également isLoaded() et unload().

QString QLibrary::errorString() const

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

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

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

Les numéros de version figurant à la fin sont ignorés sous Unix.

bool QLibrary::isLoaded() const

Renvoie ` true ` si ` load()` a abouti ; sinon, renvoie ` false`.

Voir également load().

bool QLibrary::load()

Charge la bibliothèque et renvoie true si le chargement s'est déroulé avec succès ; sinon, renvoie false. Étant donné que resolve() appelle toujours cette fonction avant de résoudre tout symbole, il n'est pas nécessaire de l'appeler explicitement. Dans certaines situations, vous pouvez souhaiter que la bibliothèque soit chargée à l'avance ; dans ce cas, vous utiliserez cette fonction.

Voir également 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 depuis la bibliothèque. Cela signifie que la fonction doit être encapsulée dans une fonction ` extern "C" ` si la bibliothèque est compilée avec un compilateur C++. Sous Windows, vous devez également exporter explicitement la fonction depuis la DLL à l'aide de la directive de compilation ` __declspec(dllexport) `, par exemple :

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

avec ` MY_EXPORT ` défini comme suit :

#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'à la fermeture de l'application.

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 dont le numéro de version complet est version et renvoie l'adresse du symbole exporté symbol. Notez que fileName ne doit pas inclure l'extension de fichier spécifique à la plate-forme ; (voir fileName). La bibliothèque reste chargée jusqu'à la fermeture de l'application. 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 dont le numéro de version majeure est 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'à la fermeture de l'application. 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 version complet respectivement sur fileName et version. Le paramètre « version » est ignoré sous Windows.

Voir également setFileName().

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

Définit la propriété « fileName » et le numéro de version majeur respectivement sur fileName et versionNumber. La propriété « versionNumber » est ignorée sous Windows.

Voir également setFileName().

bool QLibrary::unload()

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

Cette opération s'effectue automatiquement à la fermeture de l'application ; vous ne devriez donc 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 sous 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 également ` resolve()` et ` load()`.