std::enable_shared_from_this<T>::shared_from_this
std::shared_ptr<T> shared_from_this(); | (1) | (since C++11) |
std::shared_ptr<T const> shared_from_this() const; | (2) | (since C++11) |
Возвращает std::shared_ptr<T>, который разделяет владение *this со всеми существующими std::shared_ptr, которые ссылаются на *this.
Эффективно выполняет std::shared_ptr<T>(weak_this), где weak-this - это только для экспонирования изменяемое член-std::weak_ptr<T> объекта enable_shared_from_this.
Значение возврата
std::shared_ptr<T>, который разделяет владение *this с предварительно существующими std::shared_ptr.
Исключения
Если shared_from_this вызывается для объекта, который не был предварительно разделен с помощью std::shared_ptr, выбрасывается std::bad_weak_ptr (конструктором shared_ptr из созданного по умолчанию weak-this).
Пример
#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";
}Вывод:
Foo::Foo pf2 is gone Foo::~Foo
Отчёты об ошибках
Следующие отчёты об ошибках, изменяющие поведение, были применены ретроактивно к ранее опубликованным стандартам C++.
| DR | Применено к | Поведение, как опубликовано | Правильное поведение |
|---|---|---|---|
| LWG 2529 | C++11 | вызов shared_from_this для неразделяемого объекта был неопределённым поведением | Выбрасывается std::bad_weak_ptr. |
См. также
|
(C++11) | интеллектуальный указатель со смыслом совместного владения объектом (шаблон класса) |
© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/memory/enable_shared_from_this/shared_from_this