QWeakPointer Class

Dokumentation der Mitgliedsfunktionen

Gibt true nur dann zurück, wenn dieser Smart Pointer in einer implementierungsdefinierten, besitzerbasierten Reihenfolge vor other steht. Die Reihenfolge ist so, dass zwei intelligente Zeiger als äquivalent betrachtet werden, wenn sie beide leer sind oder wenn sie beide dasselbe Objekt besitzen (selbst wenn ihr offensichtlicher Typ und Zeiger unterschiedlich sind).

Diese Funktion wurde in Qt 6.7 eingeführt.

Siehe auch owner_equal.

Gibt true zurück, wenn und nur wenn dieser Smart Pointer und other denselben Eigentümer haben.

Diese Funktion wurde in Qt 6.7 eingeführt.

Siehe auch owner_before und owner_hash.

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

Gibt einen Owner-basierten Hash-Wert für dieses Smart-Pointer-Objekt zurück. Smart Pointer, die gleich verglichen werden (gemäß owner_equal), haben einen identischen Owner-basierten Hash-Wert.

Diese Funktion wurde in Qt 6.7 eingeführt.

Siehe auch owner_equal.

QWeakPointer::QWeakPointer()

Erzeugt einen QWeakPointer, der auf nichts zeigt.

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

Erzeugt einen QWeakPointer, der eine schwache Referenz auf den von other referenzierten Zeiger enthält.

Wenn T ein abgeleiteter Typ des Template-Parameters dieser Klasse ist, führt QWeakPointer einen automatischen Cast durch. Andernfalls erhalten Sie einen Compilerfehler.

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

Erzeugt einen QWeakPointer, der eine schwache Referenz auf den von other referenzierten Zeiger enthält.

Wenn T ein abgeleiteter Typ des Template-Parameters dieser Klasse ist, führt QWeakPointer einen automatischen Cast durch. Andernfalls erhalten Sie einen Compilerfehler.

QWeakPointer::~QWeakPointer()

Zerstört dieses QWeakPointer Objekt. Der Zeiger, auf den dieses Objekt verweist, wird nicht gelöscht.

void QWeakPointer::clear()

Löscht dieses QWeakPointer Objekt, wobei der Verweis, den es möglicherweise auf den Zeiger hatte, gelöscht wird.

bool QWeakPointer::isNull() const

Gibt true zurück, wenn dieses Objekt auf nullptr verweist.

Beachten Sie, dass aufgrund der Natur schwacher Referenzen der Zeiger, auf den QWeakPointer verweist, jederzeit zu nullptr werden kann, so dass sich der von dieser Funktion zurückgegebene Wert von einem Aufruf zum nächsten von false zu true ändern kann.

QSharedPointer<T> QWeakPointer::lock() const

Dasselbe wie toStrongRef().

Diese Funktion ist für die API-Kompatibilität mit std::weak_ptr vorgesehen.

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

Tauscht diese schwache Zeigerinstanz mit other aus. Dieser Vorgang ist sehr schnell und schlägt nie fehl.

QSharedPointer<T> QWeakPointer::toStrongRef() const

Erhöht diesen schwachen Verweis auf einen starken Verweis und gibt ein QSharedPointer Objekt zurück, das diesen Verweis enthält. Bei der Umwandlung in QSharedPointer prüft diese Funktion, ob das Objekt bereits gelöscht wurde oder nicht. Ist dies nicht der Fall, erhöht diese Funktion die Anzahl der Verweise auf das gemeinsam genutzte Objekt und stellt damit sicher, dass es nicht gelöscht wird.

Da diese Funktion keine gültige starke Referenz auf das gemeinsam genutzte Objekt erhalten kann, sollten Sie immer überprüfen, ob die Umwandlung erfolgreich war, indem Sie QSharedPointer::isNull() für das zurückgegebene Objekt aufrufen.

Der folgende Code wandelt beispielsweise eine gehaltene QWeakPointer in eine starke Referenz um und gibt bei Erfolg den Wert der gehaltenen Ganzzahl aus:

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

Siehe auch QSharedPointer::QSharedPointer().

bool QWeakPointer::operator bool() const

Gibt true zurück, wenn der enthaltene Zeiger nicht nullptr ist. Diese Funktion eignet sich für die Verwendung in if-constructs, wie:

    if (weakref) { ... }

Beachten Sie, dass aufgrund der Natur von schwachen Referenzen der Zeiger, auf den QWeakPointer verweist, jederzeit zu nullptr werden kann, so dass sich der von dieser Funktion zurückgegebene Wert von einem Aufruf zum nächsten von true zu false ändern kann.

Siehe auch isNull().

bool QWeakPointer::operator!() const

Gibt true zurück, wenn dieses Objekt auf nullptr verweist. Diese Funktion eignet sich für die Verwendung in if-constructs, wie:

    if (!weakref) { ... }

Beachten Sie, dass aufgrund der Natur von schwachen Referenzen der Zeiger, auf den QWeakPointer verweist, jederzeit zu nullptr werden kann, so dass sich der von dieser Funktion zurückgegebene Wert von einem Aufruf zum nächsten von false zu true ändern kann.

Siehe auch isNull().

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

Lässt dieses Objekt den Zeiger von other gemeinsam nutzen. Die aktuelle Zeigerreferenz wird verworfen, aber nicht gelöscht.

Wenn T ein abgeleiteter Typ des Template-Parameters dieser Klasse ist, wird QWeakPointer einen automatischen Cast durchführen. Andernfalls erhalten Sie einen Compilerfehler.

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

Lässt dieses Objekt den Zeiger von other gemeinsam nutzen. Die aktuelle Zeigerreferenz wird verworfen, aber nicht gelöscht.

Wenn T ein abgeleiteter Typ des Template-Parameters dieser Klasse ist, wird QWeakPointer einen automatischen Cast durchführen. Andernfalls erhalten Sie einen Compilerfehler.