# std::enable_shared_from_this<T>::shared_from_this

> C++ Atlas: `cppatlas.com/w/cpp/memory/enable_shared_from_this/shared_from_this` | Source: https://en.cppreference.com/w/cpp/memory/enable_shared_from_this/shared_from_this | Domain: Memory management | Standards: C++11

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

## Official Specification Summary (cppreference)

```cpp
std::shared_ptr<T> shared_from_this(); // (1) (since C++11)
std::shared_ptr<T const> shared_from_this() const; // (2) (since C++11)
```

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

### Return value

`std::shared_ptr<T>(weak_this)`

### Exceptions

If `shared_from_this` is called on an object that is not previously shared by `std::shared_ptr`, `std::bad_weak_ptr` is thrown by the `std::shared_ptr` constructor.

### Example

```cpp
#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:

```text
Foo::Foo
pf2 is gone
Foo::~Foo
```

### See also

- [`shared_ptr`](https://en.cppreference.com/w/cpp/memory/shared_ptr) (C++11): smart pointer with shared object ownership semantics (class template)

---
Attribution: content from https://en.cppreference.com/w/cpp/memory/enable_shared_from_this/shared_from_this (cppreference.com), licensed under CC-BY-SA 3.0 and GFDL. Modified: converted to markdown, study notes added. Offline snapshot of 9 February 2025.