std::shared_ptr<T>:: shared_ptr

다양한 포인터 타입으로부터 관리할 객체를 참조하는 shared_ptr 을 생성합니다.

T 가 배열 타입이 아닐 때, 오버로드 (3,4,6) 은 shared_from_this 를 ptr 와 함께 사용 가능하게 하며, 오버로드 (13) 은 shared_from_this 를 r. release ( ) 가 반환하는 포인터와 함께 사용 가능하게 합니다.

매개변수

사후 조건

예외

참고 사항

생성자가 shared_from_this 을 활성화한다는 것은 U* 타입의 포인터 ptr 을 사용하여 U 가 명확하고 접근 가능한 (C++17부터) std::enable_shared_from_this 의 특수화인 베이스 클래스를 가지고 있는지 판단하고, 만약 그렇다면 생성자가 다음을 평가한다는 의미입니다: if ( ptr ! = nullptr && ptr - > weak_this  . expired ( ) )
ptr - > weak_this = std:: shared_ptr < std:: remove_cv_t < U >>
( * this, const_cast < std:: remove_cv_t < U > * > ( ptr ) ) ; .

weak_this 에 대한 할당은 원자적이지 않으며 동일한 객체에 대한 잠재적 동시 접근과 충돌합니다. 이는 향후 shared_from_this() 호출이 이 raw 포인터 생성자로 생성된 std::shared_ptr 와 소유권을 공유하도록 보장합니다.

위 코드의 테스트 ptr - > weak_this  . expired ( ) 는 weak_this 가 이미 소유자를 가리키고 있을 경우 재할당되지 않도록 보장합니다. 이 테스트는 C++17부터 필수적으로 요구됩니다.

원시 포인터 오버로드는 가리키는 객체의 소유권을 가정합니다. 따라서 이미 shared_ptr 에 의해 관리되는 객체에 대해 원시 포인터 오버로드를 사용하여 shared_ptr 을 생성하는 것은(예: shared_ptr ( ptr. get ( ) ) ), 해당 객체가 std::enable_shared_from_this 에서 파생된 타입인 경우에도 정의되지 않은 동작을 초래할 가능성이 높습니다.

기본 생성자가 constexpr 이므로, 정적 shared_ptr들은 정적 비지역 변수 초기화 과정에서 동적 비지역 초기화가 시작되기 전에 초기화됩니다. 이로 인해 어떤 정적 객체의 생성자에서도 shared_ptr을 안전하게 사용할 수 있습니다.

C++11과 C++14에서는 std:: unique_ptr < T [ ] > 로부터 std:: shared_ptr < T > 를 생성하는 것이 유효합니다:

std::unique_ptr<int[]> arr(new int[1]);
std::shared_ptr<int> ptr(std::move(arr));

shared_ptr 가 std:: default_delete < T [ ] > 객체)를 std::unique_ptr 로부터 획득하므로, 배열이 올바르게 해제됩니다.

이것은 C++17에서 더 이상 허용되지 않습니다. 대신 배열 형식인 std:: shared_ptr < T [ ] > 을 사용해야 합니다.

예제

#include <iostream>
#include <memory>
struct Foo
{
    int id{0};
    Foo(int i = 0) : id{i} { std::cout << "Foo::Foo(" << i <<  ")\n"; }
    ~Foo() { std::cout << "Foo::~Foo(), id=" << id << '\n'; }
};
struct D
{
    void operator()(Foo* p) const
    {
        std::cout << "Call delete from function object. Foo::id=" << p->id << '\n';
        delete p;
    }
};
int main()
{
    {
        std::cout << "1) constructor with no managed object\n";
        std::shared_ptr<Foo> sh1;
    }
    {
        std::cout << "2) constructor with object\n";
        std::shared_ptr<Foo> sh2(new Foo{10});
        std::cout << "sh2.use_count(): " << sh2.use_count() << '\n';
        std::shared_ptr<Foo> sh3(sh2);
        std::cout << "sh2.use_count(): " << sh2.use_count() << '\n';
        std::cout << "sh3.use_count(): " << sh3.use_count() << '\n';
    }
    {
        std::cout << "3) constructor with object and deleter\n";
        std::shared_ptr<Foo> sh4(new Foo{11}, D());
        std::shared_ptr<Foo> sh5(new Foo{12}, [](auto p)
        {
            std::cout << "Call delete from lambda... p->id=" << p->id << '\n';
            delete p;
        });
    }
}

1) constructor with no managed object
2) constructor with object
Foo::Foo(10)
sh2.use_count(): 1
sh2.use_count(): 2
sh3.use_count(): 2
Foo::~Foo(), id=10
3) constructor with object and deleter
Foo::Foo(11)
Foo::Foo(12)
Call delete from lambda... p->id=12
Foo::~Foo(), id=12
Call delete from function object. Foo::id=11
Foo::~Foo(), id=11

결함 보고서

다음의 동작 변경 결함 보고서들은 이전에 발표된 C++ 표준에 소급 적용되었습니다.

참고 항목