QWeakPointer Class

Documentation sur les fonctions membres

QWeakPointer::QWeakPointer()

Crée un QWeakPointer qui ne pointe vers rien.

QWeakPointer::QWeakPointer(const QSharedPointer<T> &other)

Crée un QWeakPointer contenant une référence faible au pointeur référencé par ` other`.

Si T est un type dérivé du paramètre de modèle de cette classe, QWeakPointer effectuera une conversion automatique. Dans le cas contraire, vous obtiendrez une erreur de compilation.

[noexcept] QWeakPointer::QWeakPointer(const QWeakPointer<T> &other)

Crée un QWeakPointer contenant une référence faible vers le pointeur indiqué par other.

Si T est un type dérivé du paramètre de modèle de cette classe, QWeakPointer effectuera un transtypage automatique. Dans le cas contraire, vous obtiendrez une erreur de compilation.

QWeakPointer::~QWeakPointer()

Supprime cet objet de type « QWeakPointer ». Le pointeur référencé par cet objet ne sera pas supprimé.

void QWeakPointer::clear()

Efface cet objet ` QWeakPointer `, en supprimant la référence qu'il pouvait avoir vers le pointeur.

bool QWeakPointer::isNull() const

Renvoie ` true ` si cet objet fait référence à ` nullptr`.

Notez qu'en raison de la nature des références faibles, le pointeur auquel QWeakPointer fait référence peut devenir nullptr à tout moment ; ainsi, la valeur renvoyée par cette fonction peut passer de « faux » à « vrai » d'un appel à l'autre.

QSharedPointer<T> QWeakPointer::lock() const

Identique à ` toStrongRef()`.

Cette fonction est fournie pour assurer la compatibilité de l'API avec std::weak_ptr.

Renvoie « true » si et seulement si ce pointeur intelligent précède « other » dans un ordre défini par l'implémentation et basé sur la propriété. Cet ordre est tel que deux pointeurs intelligents sont considérés comme équivalents s'ils sont tous deux vides ou s'ils possèdent tous deux le même objet (même si leur type apparent et leur pointeur sont différents).

Ces fonctions ont été introduites dans Qt 6.7.

Voir également owner_equal.

Renvoie ` true ` si et seulement si ce pointeur intelligent et ` other ` partagent la propriété.

Ces fonctions ont été introduites dans Qt 6.7.

Voir également owner_before et owner_hash.

[noexcept, since 6.7] size_t QWeakPointer::owner_hash() const

Renvoie une valeur de hachage basée sur le propriétaire pour cet objet pointeur intelligent. Les pointeurs intelligents qui sont considérés comme égaux (conformément à owner_equal) auront un hachage basé sur le propriétaire identique.

Ces fonctions ont été introduites dans Qt 6.7.

Voir également owner_equal.

[noexcept] void QWeakPointer::swap(QWeakPointer<T> &other)

Remplace cette instance de pointeur faible par other. Cette opération est très rapide et ne rencontre jamais d'échec.

QSharedPointer<T> QWeakPointer::toStrongRef() const

Convertit cette référence faible en référence forte et renvoie un objet de type ` QSharedPointer ` contenant cette référence. Lors de la conversion en ` QSharedPointer`, cette fonction vérifie si l'objet a déjà été supprimé ou non. Si ce n'est pas le cas, elle augmente le compteur de références de l'objet partagé, garantissant ainsi qu'il ne sera pas supprimé.

Étant donné que cette fonction peut ne pas parvenir à obtenir une référence forte valide vers l’objet partagé, vous devez toujours vérifier si la conversion a réussi, en appelant ` QSharedPointer::isNull()` sur l’objet renvoyé.

Par exemple, le code suivant convertit une QWeakPointer qui était détenue en une référence forte et, en cas de réussite, affiche la valeur de l’entier qui était détenu :

QWeakPointer<int> weakref;

// ...

QSharedPointer<int> strong = weakref.toStrongRef();
if (strong)
    qDebug() << "The value is:" << *strong;
sinon
    qDebug() << "The value has already been deleted";

Voir également QSharedPointer::QSharedPointer().

QWeakPointer::operator bool() const

Renvoie ` true ` si le pointeur contenu n'est pas ` nullptr`. Cette fonction est adaptée à une utilisation dans ` if-constructs`, comme par exemple :

if (weakref) { /*...*/ }

Notez qu’en raison de la nature des références faibles, le pointeur auquel QWeakPointer fait référence peut devenir nullptr à tout moment ; la valeur renvoyée par cette fonction peut donc passer de vrai à faux d’un appel à l’autre.

Voir également isNull().

bool QWeakPointer::operator!() const

Renvoie true si cet objet fait référence à nullptr. Cette fonction est adaptée à une utilisation dans if-constructs, par exemple :

if (!weakref) { /*...*/ }

Notez qu’en raison de la nature des références faibles, le pointeur auquel QWeakPointer fait référence peut devenir nullptr à tout moment ; la valeur renvoyée par cette fonction peut donc passer de « false » à « true » d’un appel à l’autre.

Voir également isNull().

QWeakPointer<T> &QWeakPointer::operator=(const QSharedPointer<T> &other)

Fait en sorte que cet objet partage le pointeur de ` other`. La référence au pointeur actuel est ignorée, mais n'est pas supprimée.

Si T est un type dérivé du paramètre de modèle de cette classe, QWeakPointer effectuera une conversion automatique. Dans le cas contraire, vous obtiendrez une erreur de compilation.

[noexcept] QWeakPointer<T> &QWeakPointer::operator=(const QWeakPointer<T> &other)

Fait en sorte que cet objet partage le pointeur de ` other`. La référence au pointeur actuel est ignorée, mais n'est pas supprimée.

Si T est un type dérivé du paramètre de modèle de cette classe, QWeakPointer effectuera une conversion automatique. Dans le cas contraire, vous obtiendrez une erreur de compilation.