Namensräume
Varianten
Aktionen

std::unique_ptr<T,Deleter>::reset

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

Allocatoren
(C++11)
(C++23)
(C++11)
(C++11)
(C++20)
(C++20)
(C++20) 
(C++11)
(C++17)
Speicherressourcen
(C++17)
(C++17)
(C++17)
(C++17)
(C++17)
(C++17)
(C++17)
(C++17)
(C++17)
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
(bis C++20*)
(bis C++20*)
(bis C++20*)
Explizites Lebenszeitmanagement
(C++23)(C++23)
 
std::unique_ptr
 
Mitglieder der primären Vorlage, unique_ptr<T>
void reset( pointer ptr = pointer() ) noexcept;
 (1) (constexpr seit C++23)
Mitglieder der Spezialisierung unique_ptr<T[]>
template< class U >
void reset( U ptr ) noexcept;
 (2) (constexpr seit C++23)
void reset( std::nullptr_t = nullptr ) noexcept;
 (3) (constexpr seit C++23)

Ersetzt das verwaltete Objekt.

1,2) Äquivalent zu auto old_ptr = get();
/* weist "ptr" dem gespeicherten Zeiger zu */
if (old_ptr)
    get_deleter()(old_ptr);.
Wenn get_deleter()(old_ptr) eine Ausnahme auslöst, ist das Verhalten undefiniert.
2) Diese Überladung nimmt an der Überladungsauflösung teil, wenn U vom gleichen Typ wie pointer ist oder alle folgenden Bedingungen erfüllt sind
  • pointer ist vom gleichen Typ wie element_type*.
  • U ist ein Zeigertyp V*, so dass V(*)[] zu element_type(*)[] konvertierbar ist.
3) Äquivalent zu reset(pointer()).

Inhalt

[bearbeiten] Parameter

ptr - Zeiger auf ein neues zu verwaltendes Objekt

[bearbeiten] Hinweise

Um das verwaltete Objekt zu ersetzen und gleichzeitig einen neuen Deleter bereitzustellen, kann der Move-Zuweisungsoperator verwendet werden.

Ein Test auf Selbst-Reset, d.h. ob ptr auf ein Objekt zeigt, das bereits von *this verwaltet wird, wird nicht durchgeführt, außer wo dies als Compiler-Erweiterung oder als Debugging-Assertion bereitgestellt wird. Beachten Sie, dass Code wie p.reset(p.release()) kein Selbst-Reset beinhaltet, sondern nur Code wie p.reset(p.get()).

[bearbeiten] Beispiel

Führen Sie diesen Code aus
#include <iostream>
#include <memory>
 
struct Foo // object to manage
{
    Foo() { std::cout << "Foo...\n"; }
    ~Foo() { std::cout << "~Foo...\n"; }
};
 
struct D // deleter
{
    void operator() (Foo* p)
    {
        std::cout << "Calling delete for Foo object... \n";
        delete p;
    }
};
 
int main()
{
    std::cout << "Creating new Foo...\n";
    std::unique_ptr<Foo, D> up(new Foo(), D()); // up owns the Foo pointer (deleter D)
 
    std::cout << "Replace owned Foo with a new Foo...\n";
    up.reset(new Foo());  // calls deleter for the old one
 
    std::cout << "Release and delete the owned Foo...\n";
    up.reset(nullptr);      
}

Ausgabe

Creating new Foo...
Foo...
Replace owned Foo with a new Foo...
Foo...
Calling delete for Foo object...
~Foo...
Release and delete the owned Foo...
Calling delete for Foo object...
~Foo...

[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 2118 C++11 unique_ptr<T[]>::reset hat Qualifikationskonvertierungen abgelehnt akzeptiert
LWG 2169 C++11 die Überladung unique_ptr<T[]>::reset(pointer) existierte entfernte die Überladung

[bearbeiten] Siehe auch

 Gibt einen Zeiger auf das verwaltete Objekt zurück und gibt die Eigentümerschaft frei
(öffentliche Memberfunktion) [bearbeiten]
Abgerufen von "https://cppreference.de/mwiki/index.php?title=cpp/memory/unique_ptr/reset&oldid=177110"