QExplicitlySharedDataPointer Class

Dokumentation der Mitgliedsfunktionen

[noexcept] QExplicitlySharedDataPointer::QExplicitlySharedDataPointer()

Konstruiert einen QExplicitlySharedDataPointer, initialisiert mit nullptr als d-Zeiger.

[explicit noexcept] QExplicitlySharedDataPointer::QExplicitlySharedDataPointer(T *data)

Konstruiert einen QExplicitlySharedDataPointer mit dem Zeiger d, der auf data gesetzt ist, und erhöht die Referenzanzahl von data.

[noexcept] template <typename X> QExplicitlySharedDataPointer::QExplicitlySharedDataPointer(const QExplicitlySharedDataPointer<X> &o)

Dieser Kopierkonstruktor unterscheidet sich insofern, als dass o ein anderer Typ eines explizit gemeinsam genutzten Datenzeigers sein kann, der jedoch ein kompatibles gemeinsam genutztes Datenobjekt hat.

Standardmäßig wird der d-Zeiger von o (vom Typ X *) implizit in den Typ T * konvertiert; das Ergebnis dieser Konvertierung wird als d-Zeiger von this gesetzt, und der Referenzzähler des gemeinsamen Datenobjekts wird erhöht.

Wenn jedoch das Makro QT_ENABLE_QEXPLICITLYSHAREDDATAPOINTER_STATICCAST definiert wird, bevor der Header QExplicitlySharedDataPointer eingefügt wird, dann wird der d-Zeiger von o in den Typ static_cast umgewandelt ( T *). Das Ergebnis des Casts wird dann als d-Zeiger dieses Typs gesetzt, und der Referenzzähler des gemeinsam genutzten Datenobjekts wird inkrementiert.

    QExplicitlySharedDataPointer<Base> base(new Base);
    QExplicitlySharedDataPointer<Derived> derived(base); // !!! DANGER !!!

Ab Qt 5.4 ist der Cast standardmäßig deaktiviert. Es ist möglich, ihn wieder zu aktivieren, indem man das QT_ENABLE_QEXPLICITLYSHAREDDATAPOINTER_STATICCAST Makro definiert, und somit zu ermöglichen, dass alter Code (der sich auf diese Funktion verlassen hat) ohne Änderungen kompiliert werden kann.

[noexcept] QExplicitlySharedDataPointer::QExplicitlySharedDataPointer(const QExplicitlySharedDataPointer<T> &o)

Dieser Standard-Kopierkonstruktor setzt den d-Zeiger von this auf den d-Zeiger in o und erhöht die Referenzanzahl des gemeinsamen Datenobjekts.

[noexcept] QExplicitlySharedDataPointer::QExplicitlySharedDataPointer(QExplicitlySharedDataPointer<T> &&o)

Move-konstruiert eine QExplicitlySharedDataPointer-Instanz, die auf das gleiche Objekt zeigt, auf das o gezeigt hat.

QExplicitlySharedDataPointer::~QExplicitlySharedDataPointer()

Verringert die Referenzanzahl des gemeinsamen Datenobjekts. Wenn der Referenzzähler 0 wird, wird das gemeinsame Datenobjekt gelöscht. Anschließend wird es zerstört.

[protected] T *QExplicitlySharedDataPointer::clone()

Erstellt eine tiefe Kopie der aktuellen Daten und gibt sie zurück. Diese Funktion wird von detach() aufgerufen, wenn die Referenzanzahl größer als 1 ist, um die neue Kopie zu erstellen. Diese Funktion verwendet den Operator new und ruft den Kopierkonstruktor des Typs T auf.

Siehe QSharedDataPointer<T>::clone() für eine Erklärung, wie man sie benutzt.

[noexcept] const T *QExplicitlySharedDataPointer::constData() const

Gibt einen Konstantenzeiger auf das gemeinsame Datenobjekt zurück.

Siehe auch data().

[noexcept] T *QExplicitlySharedDataPointer::data() const

Gibt einen Zeiger auf das gemeinsame Datenobjekt zurück.

void QExplicitlySharedDataPointer::detach()

Wenn die Referenzanzahl des gemeinsamen Datenobjekts größer als 1 ist, erstellt diese Funktion eine tiefe Kopie des gemeinsamen Datenobjekts und setzt den d-Zeiger dieses Objekts auf die Kopie.

Da QExplicitlySharedDataPointer nicht die automatische Kopie bei Schreiboperationen durchführt, die Mitglieder von QSharedDataPointer durchführen, wird detach() nirgendwo in den Mitgliedsfunktionen dieser Klasse automatisch aufgerufen. Wenn Sie feststellen, dass Sie detach() überall in Ihrem Code aufrufen, sollten Sie stattdessen QSharedDataPointer verwenden.

[noexcept, since 6.0] T *QExplicitlySharedDataPointer::get() const

Dasselbe wie data(). Diese Funktion wird aus Gründen der STL-Kompatibilität bereitgestellt.

Diese Funktion wurde in Qt 6.0 eingeführt.

[noexcept, since 6.0] void QExplicitlySharedDataPointer::reset(T *ptr = nullptr)

Setzt den d-Zeiger von this auf ptr und erhöht den Referenzzähler von ptr, wenn ptr nicht nullptr ist. Der Referenzzähler des alten gemeinsamen Datenobjekts wird dekrementiert, und das Objekt wird gelöscht, wenn der Referenzzähler 0 erreicht.

Diese Funktion wurde in Qt 6.0 eingeführt.

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

Tauscht diesen explizit freigegebenen Datenzeiger mit other aus. Dieser Vorgang ist sehr schnell und schlägt nie fehl.

[noexcept] T *QExplicitlySharedDataPointer::take()

Gibt einen Zeiger auf das gemeinsam genutzte Objekt zurück und setzt dieses auf nullptr zurück. (Das heißt, diese Funktion setzt den d-Zeiger von this auf nullptr.)

[noexcept] bool QExplicitlySharedDataPointer::operator bool() const

Gibt true zurück, wenn der d-Zeiger von this nicht null ist.

[noexcept] bool QExplicitlySharedDataPointer::operator!() const

Gibt true zurück, wenn der d-Zeiger von this nullptr ist.

T &QExplicitlySharedDataPointer::operator*() const

Ermöglicht den Zugriff auf die Mitglieder des gemeinsamen Datenobjekts.

[noexcept] T *QExplicitlySharedDataPointer::operator->()

Ermöglicht den Zugriff auf die Mitglieder des gemeinsamen Datenobjekts.

[noexcept] T *QExplicitlySharedDataPointer::operator->() const

Bietet konstanten Zugriff auf die Mitglieder des gemeinsamen Datenobjekts.

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

Verschieben - weist other dieser QExplicitlySharedDataPointer Instanz zu.

[noexcept] QExplicitlySharedDataPointer<T> &QExplicitlySharedDataPointer::operator=(T *o)

Setzt den d-Zeiger von this auf o und erhöht die Referenzanzahl von o. Der Referenzzähler des alten gemeinsamen Datenobjekts von this wird dekrementiert. Wenn der Referenzzähler des alten gemeinsamen Datenobjekts 0 wird, wird das alte gemeinsame Datenobjekt gelöscht.

[noexcept] QExplicitlySharedDataPointer<T> &QExplicitlySharedDataPointer::operator=(const QExplicitlySharedDataPointer<T> &o)

Setzt den d-Zeiger von this auf den d-Zeiger von o und erhöht die Referenzanzahl des gemeinsamen Datenobjekts. Der Referenzzähler des alten gemeinsamen Datenobjekts von this wird dekrementiert. Wenn der Referenzzähler des alten gemeinsamen Datenobjekts 0 wird, wird das alte gemeinsame Datenobjekt gelöscht.