QWeakPointer Class

Dokumentation zu Mitgliedsfunktionen

QWeakPointer::QWeakPointer()

Erstellt einen QWeakPointer, der auf nichts verweist.

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

Erstellt einen QWeakPointer, der eine schwache Referenz auf den Zeiger enthält, auf den other verweist.

Wenn T ein abgeleiteter Typ des Template-Parameters dieser Klasse ist, führt QWeakPointer eine automatische Typumwandlung durch. Andernfalls wird ein Compilerfehler ausgegeben.

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

Erstellt einen QWeakPointer, der eine schwache Referenz auf den Zeiger enthält, auf den other verweist.

Wenn T ein abgeleiteter Typ des Template-Parameters dieser Klasse ist, führt QWeakPointer eine automatische Typumwandlung durch. Andernfalls wird ein Compilerfehler ausgegeben.

QWeakPointer::~QWeakPointer()

Löscht dieses „ QWeakPointer “-Objekt. Der Zeiger, auf den dieses Objekt verweist, wird nicht gelöscht.

void QWeakPointer::clear()

Löscht dieses „ QWeakPointer “-Objekt und hebt dabei den Verweis auf, den es möglicherweise auf den Zeiger hatte.

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, sodass 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

Entspricht ` toStrongRef()`.

Diese Funktion wird aus Gründen der API-Kompatibilität mit std::weak_ptr bereitgestellt.

Gibt „ true “ genau dann zurück, wenn dieser Smart-Pointer in einer implementierungsabhängigen, eigentümerbasierten Reihenfolge vor „ other “ steht. Die Reihenfolge ist so festgelegt, dass zwei Smart-Pointer als gleichwertig gelten, wenn sie beide leer sind oder wenn sie beide dasselbe Objekt besitzen (auch wenn ihr scheinbarer Typ und ihr Zeiger unterschiedlich sind).

Diese Funktionen wurden in Qt 6.7 eingeführt.

Siehe auch owner_equal.

Gibt „ true “ zurück, genau dann, wenn dieser Smart-Pointer und „ other “ sich das Eigentumsrecht teilen.

Diese Funktionen wurden 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 eigentümerbasierten Hash-Wert für dieses Smart-Pointer-Objekt zurück. Smart-Pointer, die (gemäß owner_equal) als gleich angesehen werden, weisen einen identischen eigentümerbasierten Hash auf.

Diese Funktionen wurden in Qt 6.7 eingeführt.

Siehe auch owner_equal.

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

Ersetzt diese Instanz eines schwachen Zeigers durch other. Dieser Vorgang ist sehr schnell und schlägt niemals fehl.

QSharedPointer<T> QWeakPointer::toStrongRef() const

Wandelt diese schwache Referenz in eine starke um und gibt ein ` QSharedPointer `-Objekt zurück, das diese Referenz enthält. Bei der Umwandlung in eine ` QSharedPointer`-Referenz prüft diese Funktion, ob das Objekt bereits gelöscht wurde oder nicht. Ist dies nicht der Fall, erhöht diese Funktion die Referenzanzahl des gemeinsam genutzten Objekts und stellt so sicher, dass es nicht gelöscht wird.

Da es dieser Funktion möglicherweise nicht gelingt, eine gültige starke Referenz auf das gemeinsam genutzte Objekt zu erhalten, sollten Sie stets überprüfen, ob die Konvertierung erfolgreich war, indem Sie QSharedPointer::isNull() für das zurückgegebene Objekt aufrufen.

Der folgende Code wandelt beispielsweise eine „ QWeakPointer “, die gehalten wurde, 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().

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 “, beispielsweise:

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

Beachten Sie, dass aufgrund der Natur schwacher Referenzen der Zeiger, auf den QWeakPointer verweist, jederzeit zu nullptr werden kann, sodass 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 “, beispielsweise:

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

Beachten Sie, dass aufgrund der Natur schwacher Referenzen der Zeiger, auf den QWeakPointer verweist, jederzeit zu nullptr werden kann, sodass 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 Vorlagenparameters dieser Klasse ist, führt „ QWeakPointer “ eine automatische Typumwandlung durch. Andernfalls wird ein Compilerfehler ausgegeben.

[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 Vorlagenparameters dieser Klasse ist, führt „ QWeakPointer “ eine automatische Typumwandlung durch. Andernfalls wird ein Compilerfehler ausgegeben.