unique_ptr::release

Libère la propriété du pointeur stocké retourné pour l'appelant et définit la valeur de pointeur stocké sur nullptr.

pointer release();

Valeur de propriété/valeur de retour

Retourne le pointeur stocké.

Notes

Utilisez release pour prendre possession du pointeur brut stocké par le pointeur unique_ptr. L'appelant est responsable de la suppression du pointeur retourné. Le pointeur unique-ptr est défini sur l'état construit par défaut vide. Vous pouvez affecter un autre pointeur de type compatible au pointeur unique_ptr après l'appel à release.

Exemple

Cet exemple montre comment l'appelant de release est responsable de l'objet retourné :

// stl_release_unique.cpp
// Compile by using: cl /W4 /EHsc stl_release_unique.cpp
#include <iostream>
#include <memory>

struct Sample {
   int content_;
   Sample(int content) : content_(content) {
      std::cout << "Constructing Sample(" << content_ << ")" << std::endl;
   }
   ~Sample() {
      std::cout << "Deleting Sample(" << content_ << ")" << std::endl;
   }
};

void ReleaseUniquePointer() {
   // Use make_unique function when possible.  
   auto up1 = std::make_unique<Sample>(3);
   auto up2 = std::make_unique<Sample>(42);
   
   // Take over ownership from the unique_ptr up2 by using release
   auto ptr = up2.release();
   if (up2) {
      // This statement does not execute, because up2 is empty.
      std::cout << "up2 is not empty." << std::endl;
   }
   // We are now responsible for deletion of ptr.
   delete ptr;
   // up1 deletes its stored pointer when it goes out of scope.   
}

int main() {
   ReleaseUniquePointer();
}

Sortie de l'ordinateur :

Configuration requise

En-tête : <memory>

Espace de noms : std

Voir aussi

Tâches

Comment : créer et utiliser des instances unique_ptr

Référence

unique_ptr, classe

<memory>

Autres ressources

membres d'unique_ptr

<memory> membres