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
membres du modèle primaire, unique_ptr<T>
void reset ( pointer ptr = pointer ( ) ) noexcept ;
(1) (constexpr depuis C++23)
membres de la spécialisation unique_ptr<T[]>
template < class U >
void reset ( U ptr ) noexcept ;
(2) (constexpr depuis C++23)
void reset ( std:: nullptr_t = nullptr ) noexcept ;
(3) (constexpr depuis C++23)

Remplace l'objet géré.

1,2) Équivalent à auto old_ptr = get ( ) ;
/* assigns “ptr” to the stored pointer */
if ( old_ptr )
get_deleter ( ) ( old_ptr ) ; .
Si get_deleter ( ) ( old_ptr ) lève une exception, le comportement est indéfini.
2) Cette surcharge participe à la résolution de surcharge uniquement si U est du même type que pointer , ou si toutes les conditions suivantes sont satisfaites :
  • pointer est du même type que element_type* .
  • U est un type pointeur V* tel que V(*)[] est convertible en element_type(*)[] .
3) Équivalent à reset ( pointer ( ) ) .

Table des matières

Paramètres

ptr - pointeur vers un nouvel objet à gérer

Notes

Pour remplacer l'objet géré tout en fournissant également un nouveau suppresseur, l'opérateur d'affectation par déplacement peut être utilisé.

Un test d'auto-réinitialisation, c'est-à-dire si ptr pointe vers un objet déjà géré par * this , n'est pas effectué, sauf lorsqu'il est fourni comme extension du compilateur ou comme assertion de débogage. Notez que du code tel que p. reset ( p. release ( ) ) n'implique pas d'auto-réinitialisation, seul du code comme p. reset ( p. get ( ) ) le fait.

Exemple

Exécuter ce code 
#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);      
}

Sortie : 

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...

Rapports de défauts

Les rapports de défauts modifiant le comportement suivants ont été appliqués rétroactivement aux normes C++ précédemment publiées.

DR Appliqué à Comportement publié Comportement corrigé
LWG 2118 C++11 unique_ptr<T[]>::reset rejetait les conversions de qualification accepte
LWG 2169 C++11 la surcharge unique_ptr<T[]>::reset(pointer) existait supprimé la surcharge

Voir aussi

renvoie un pointeur vers l'objet géré et libère la propriété
(fonction membre publique)