shared_ptr::reset

Replace owned resource.

void reset();
template<class Other>
    void reset(Other *ptr;);
template<class Other, class D>
    void reset(Other *ptr, D dtor);
template<class Other, class D, class A>
    void reset(Other *ptr, D dtor, A alloc);

Parameters

• Other
  The type controlled by the argument pointer.

• D
  The type of the deleter.

• ptr
  The pointer to copy.

• dtor
  The deleter to copy.

• A
  The type of the allocator.

• alloc
  The allocator to copy.

Remarks

The operators all decrement the reference count for the resource currently owned by *this and assign ownership of the resource named by the operand sequence to *this. If the reference count falls to zero, the resource is released. If an operator fails it leaves *this unchanged.

Example

// std_tr1__memory__shared_ptr_reset.cpp 
// compile with: /EHsc 
#include <memory> 
#include <iostream> 
 
struct deleter 
    { 
    void operator()(int *p) 
        { 
        delete p; 
        } 
    }; 
 
int main() 
    { 
    std::shared_ptr<int> sp(new int(5)); 
 
    std::cout << "*sp == " << std::boolalpha 
        << *sp << std::endl; 
 
    sp.reset(); 
    std::cout << "(bool)sp == " << std::boolalpha 
        << (bool)sp << std::endl; 
 
    sp.reset(new int(10)); 
    std::cout << "*sp == " << std::boolalpha 
        << *sp << std::endl; 
 
    sp.reset(new int(15), deleter()); 
    std::cout << "*sp == " << std::boolalpha 
        << *sp << std::endl; 
 
    return (0); 
    } 
 

*sp == 5
(bool)sp == false
*sp == 10
*sp == 15

Requirements

Header: <memory>

Namespace: std

See Also

Reference

shared_ptr Class

shared_ptr::operator=

Other Resources

<memory> Members