Spec-Zone.ru › C++

std::get_deleter

Определено в заголовке <memory>
template< class Deleter, class T >
Deleter* get_deleter( const std::shared_ptr<T>& p ) noexcept;
(начиная с C++11)
(constexpr начиная с C++26)

Доступ к удалителю p.

  • Если указатель совместного владения p владеет удалителем типа Deleter без cv-квалификаторов (например, если он был создан с помощью одного из конструкторов, принимающих удалитель в качестве параметра), возвращает указатель на удалитель.
  • В противном случае возвращает нулевой указатель.

Параметры

p - указатель совместного владения, к удалителю которого требуется получить доступ

Возвращаемое значение

Указатель на принадлежащий объекту удалитель или nullptr. Возвращённый указатель действителен как минимум до тех пор, пока существует хотя бы один экземпляр shared_ptr, владеющий им.

Примечания

Возвращённый указатель может пережить последний shared_ptr, если, например, остаются экземпляры std::weak_ptr, а реализация не уничтожает удалитель до уничтожения всего блока управления.

Пример

Демонстрирует, что удалитель std::shared_ptr не зависит от типа shared_ptr.

#include <iostream>
#include <memory>

struct Foo { int i; };
void foo_deleter(Foo* p)
{
    std::cout << "foo_deleter called!\n";
    delete p;
}

int main()
{
    std::shared_ptr<int> aptr;
    
    {
        // create a shared_ptr that owns a Foo and a deleter
        auto foo_p = new Foo;
        std::shared_ptr<Foo> r(foo_p, foo_deleter);
        aptr = std::shared_ptr<int>(r, &r->i); // aliasing ctor
        // aptr is now pointing to an int, but managing the whole Foo
    } // r gets destroyed (deleter not called)
    
    // obtain pointer to the deleter:
    if (auto del_p = std::get_deleter<void(*)(Foo*)>(aptr))
    {
        std::cout << "shared_ptr<int> owns a deleter\n";
        if (*del_p == foo_deleter)
            std::cout << "...and it equals &foo_deleter\n";
    }
    else
        std::cout << "The deleter of shared_ptr<int> is null!\n";
} // deleter called here

Вывод:

shared_ptr<int> owns a deleter
...and it equals &foo_deleter
foo_deleter called!

См. также

(конструктор)
std::shared_ptr конструкторы
(открытая функция-член)
get_deleter
возвращает удалитель, используемый для уничтожения управляемого объекта
(открытая функция-член std::unique_ptr<T,Deleter>)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/memory/shared_ptr/get_deleter

Spec-Zone.ru

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