Spec-Zone.ru › C++

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.

См. также

shared_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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API