std::enable_shared_from_this::shared_from_this

From cppreference.com
 
C++
 
Utilities library
 
Dynamic memory management
Smart pointers
(C++11)
(C++11)
(C++11)
(until C++17)
(C++11)
(C++11)
(C++11)
(C++11)
Allocators
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
Uninitialized storage
(C++11)
Garbage collection support
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
Miscellaneous
(C++11)
(C++11)
(C++11)
C Library
Low level memory management
 
std::enable_shared_from_this
Protected member functions
Public member functions
enable_shared_from_this::shared_from_this
 
shared_ptr<T> shared_from_this();
 (1)
shared_ptr<T const> shared_from_this() const;
 (2)

Returns a std::shared_ptr<T> that shares ownership of *this with all existing std::shared_ptr that refer to *this.

Contents

[edit] Notes

Before calling shared_from_this, there should be at least one std::shared_ptr p that owns *this.

[edit] Return value

std::shared_ptr<T> that shares ownership of *this with pre-existing std::shared_ptrs

[edit] Example

Run this code
#include <iostream>
#include <memory>
 
struct Foo : public std::enable_shared_from_this<Foo> {
    Foo() { std::cout << "Foo::Foo\n"; }
    ~Foo() { std::cout << "Foo::~Foo\n"; } 
    std::shared_ptr<Foo> getFoo() { return shared_from_this(); }
};
 
int main() {
    Foo *f = new Foo;
    std::shared_ptr<Foo> pf1;
 
    {
        std::shared_ptr<Foo> pf2(f);
        pf1 = pf2->getFoo();  // shares ownership of object with pf2
    }
 
    std::cout << "pf2 is gone\n";   
}

Output: 

Foo::Foo
pf2 is gone
Foo::~Foo

[edit] See also

(C++11)
 smart pointer with shared object ownership semantics
(class template)
Retrieved from "http://en.cppreference.com/mwiki/index.php?title=cpp/memory/enable_shared_from_this/shared_from_this&oldid=77317"