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 qui contient une référence faible au pointeur référencé par other.

Si T est un type dérivé du paramètre 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 qui contient une référence faible au pointeur référencé par other.

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

QWeakPointer::~QWeakPointer()

Détruit l'objet 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 a pu avoir au 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 référencé par QWeakPointer peut devenir nullptr à tout moment, de sorte que 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 des raisons de compatibilité API avec std::weak_ptr.

Renvoie true si et seulement si ce pointeur intelligent précède other dans un ordre basé sur le propriétaire et défini par l'implémentation. L'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 aussi 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 aussi 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 se comparent de manière égale (conformément à owner_equal) auront un hachage identique basé sur le propriétaire.

Ces fonctions ont été introduites dans Qt 6.7.

Voir aussi 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 n'échoue jamais.

QSharedPointer<T> QWeakPointer::toStrongRef() const

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

Comme cette fonction peut échouer à obtenir une référence forte valide à l'objet partagé, vous devriez toujours vérifier si la conversion a réussi, en appelant QSharedPointer::isNull() sur l'objet retourné.

Par exemple, le code suivant promeut un QWeakPointer détenu en référence forte et, en cas de succès, imprime la valeur de l'entier détenu :

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

Voir aussi QSharedPointer::QSharedPointer().

QWeakPointer::operator bool() const

Renvoie true si le pointeur contenu n'est pas nullptr. Cette fonction peut être utilisée dans if-constructs, par exemple :

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

Notez qu'en raison de la nature des références faibles, le pointeur référencé par QWeakPointer peut devenir nullptr à tout moment, de sorte que la valeur renvoyée par cette fonction peut 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 peut être utilisée 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, de sorte que la valeur renvoyée par cette fonction peut passer de faux à vrai d'un appel à l'autre.

Voir également isNull().

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

Fait partager à cet objet le pointeur de other. La référence actuelle du pointeur est abandonnée mais n'est pas supprimée.

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

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

Fait partager à cet objet le pointeur de other. La référence actuelle du pointeur est abandonnée mais n'est pas supprimée.

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