Namespaces
Variants

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

From cppreference.net
C++
Memory management library
( exposition only* )
Allocators
Uninitialized memory algorithms
Constrained uninitialized memory algorithms
Memory resources
Uninitialized storage (until C++20)
( until C++20* )
( until C++20* )
( until C++20* )

Garbage collector support (until C++23)
(C++11) (until C++23)
(C++11) (until C++23)
(C++11) (until C++23)
(C++11) (until C++23)
(C++11) (until C++23)
(C++11) (until C++23)
std::unique_ptr
Mitglieder der primären Template, 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) Entspricht auto old_ptr = get ( ) ;
/* assigns “ptr” to the stored pointer */
if ( old_ptr )
get_deleter ( ) ( old_ptr ) ; .
Wenn get_deleter ( ) ( old_ptr ) eine Exception wirft, ist das Verhalten undefiniert.
2) Diese Überladung nimmt nur an der Überladungsauflösung teil, wenn U denselben Typ wie pointer hat oder alle folgenden Bedingungen erfüllt sind:
  • pointer denselben Typ wie element_type* hat.
  • U ein Zeigertyp V* ist, sodass V(*)[] in element_type(*)[] konvertierbar ist.
3) Entspricht reset ( pointer ( ) ) .

Inhaltsverzeichnis

Parameter

ptr - Zeiger auf ein neues zu verwaltendes Objekt

Hinweise

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

Ein Test auf Selbstrücksetzung, d.h. ob ptr auf ein bereits von * this verwaltetes Objekt zeigt, wird nicht durchgeführt, außer wenn als Compiler-Erweiterung oder als Debugging-Assert bereitgestellt. Beachten Sie, dass Code wie p. reset ( p. release ( ) ) keine Selbstrücksetzung beinhaltet, nur Code wie p. reset ( p. get ( ) ) dies tut.

Beispiel

Diesen Code ausführen 
#include <iostream>
#include <memory>
struct Foo // zu verwaltendes Objekt
{
    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 besitzt den Foo-Zeiger (Deleter D)
    std::cout << "Replace owned Foo with a new Foo...\n";
    up.reset(new Foo());  // ruft Deleter für das alte Objekt auf
    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...

Fehlerberichte

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

DR Angewendet auf Verhalten wie veröffentlicht Korrektes Verhalten
LWG 2118 C++11 unique_ptr<T[]>::reset lehnte Qualifikationskonvertierungen ab akzeptiert
LWG 2169 C++11 die Überladung unique_ptr<T[]>::reset(pointer) existierte entfernte die Überladung

Siehe auch

gibt einen Zeiger auf das verwaltete Objekt zurück und gibt die Eigentümerschaft frei
(public member function)