Namensräume
Varianten
Aktionen

std::bad_weak_ptr

Von cppreference.com
< cpp‎ | memory
 
 
Speicherverwaltungsbibliothek
(nur Exposition*)
Algorithmen für uninitialisierten Speicher
(C++17)
(C++17)
(C++17)
Beschränkte uninitialisierte
Speicher-Algorithmen
C-Bibliothek

Allocatoren
Speicherressourcen
Unterstützung für Garbage Collection
(C++11)(bis C++23)
(C++11)(bis C++23)
(C++11)(bis C++23)
(C++11)(bis C++23)
(C++11)(bis C++23)
(C++11)(bis C++23)
Uninitialisierter Speicher
Explizites Lebenszeitmanagement
 
Definiert in Header <memory>
class bad_weak_ptr;
(seit C++11)

std::bad_weak_ptr ist der Typ des Objekts, das als Ausnahme von den Konstruktoren von std::shared_ptr geworfen wird, die std::weak_ptr als Argument nehmen, wenn sich der std::weak_ptr auf ein bereits gelöschtes Objekt bezieht.

cpp/error/exceptionstd-bad weak ptr-inheritance.svg

Vererbungdiagramm

Inhalt

[bearbeiten] Memberfunktionen

(Konstruktor)
konstruiert ein neues bad_weak_ptr Objekt
(öffentliche Memberfunktion)
operator=
ersetzt das bad_weak_ptr Objekt
(öffentliche Memberfunktion)
what
gibt den erklärenden String zurück
(öffentliche Memberfunktion)

std::bad_weak_ptr::bad_weak_ptr

bad_weak_ptr() noexcept;
(1) (seit C++11)
bad_weak_ptr( const bad_weak_ptr& other ) noexcept;
(2) (seit C++11)

Konstruiert ein neues bad_weak_ptr Objekt mit einem implementierungsdefinierten, nullterminierten Byte-String, der über what() zugänglich ist.

1) Standardkonstruktor.
2) Kopierkonstruktor. Wenn *this und other beide den dynamischen Typ std::bad_weak_ptr haben, dann gilt std::strcmp(what(), other.what()) == 0.

Parameter

Sonstiges - ein anderes Ausnahmeobjekt zum Kopieren

std::bad_weak_ptr::operator=

bad_weak_ptr& operator=( const bad_weak_ptr& other ) noexcept;
(seit C++11)

Weist den Inhalt mit dem von other zu. Wenn *this und other beide den dynamischen Typ std::bad_weak_ptr haben, dann gilt std::strcmp(what(), other.what()) == 0 nach der Zuweisung.

Parameter

Sonstiges - ein anderes Ausnahmeobjekt zum Zuweisen

Rückgabewert

*this

std::bad_weak_ptr::what

virtual const char* what() const noexcept;
(seit C++11)

Gibt den erklärenden String zurück.

Rückgabewert

Zeiger auf einen implementierungsdefinierten, nullterminierten String mit erläuternden Informationen. Der String kann für die Konvertierung und Anzeige als std::wstring verwendet werden. Der Zeiger ist garantiert gültig, mindestens bis das Ausnahmeobjekt, von dem er stammt, zerstört wird, oder bis eine nicht-const Memberfunktion (z. B. der Kopierzuweisungsoperator) für das Ausnahmeobjekt aufgerufen wird.

Der zurückgegebene String ist während der konstanten Auswertung mit der gewöhnlichen Literal-Codierung kodiert.

(seit C++26)

Anmerkungen

Implementierungen dürfen what() überschreiben, sind aber nicht dazu verpflichtet.

Abgeleitet von std::exception

Memberfunktionen

[virtuell]
zerstört das Ausnahmeobjekt
(virtuelle öffentliche Memberfunktion von std::exception) [bearbeiten]
[virtuell]
gibt einen erklärenden String zurück
(virtuelle öffentliche Memberfunktion von std::exception) [bearbeiten]

[bearbeiten] Beispiel

#include <iostream>
#include <memory>
 
int main()
{
    std::shared_ptr<int> p1(new int(42));
    std::weak_ptr<int> wp(p1);
    p1.reset();
    try
    {
        std::shared_ptr<int> p2(wp);
    }
    catch (const std::bad_weak_ptr& e)
    {
        std::cout << e.what() << '\n';
    }
}

Mögliche Ausgabe

std::bad_weak_ptr

[bearbeiten] Fehlerberichte

Die folgenden Verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

DR angewendet auf Verhalten wie veröffentlicht Korrigiertes Verhalten
LWG 2376 C++11 das Aufrufen von what für einen standardmäßig konstruierten bad_weak_ptr sollte "bad_weak_ptr" zurückgeben Der Rückgabewert ist implementierungsdefiniert

[bearbeiten] Siehe auch

intelligenter Zeiger mit semantisch geteiltem Objektbesitz
(Klassen-Template) [edit]
(C++11)
schwache Referenz auf ein von std::shared_ptr verwaltetes Objekt
(Klassen-Template) [edit]