std::out_ptr

template< class Pointer = void, class Smart, class... Args >
auto out_ptr( Smart& s, Args&&... args );

Возвращает std::out_ptr_t с выведенными аргументами шаблона, который захватывает аргументы для сброса по ссылке.

Если конструирование возвращаемого значения (см. ниже) некорректно, программа некорректна.

Параметры

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

std::out_ptr_t<Smart, P, Args&&>(s, std::forward<Args>(args)...), где P — это

• Pointer, если Pointer не совпадает с void. В противном случае
• Smart::pointer, если он корректен и обозначает тип. В противном случае
• Smart::element_type*, если Smart::element_type корректен и обозначает тип. В противном случае
• std::pointer_traits<Smart>::element_type*.

Примечания

Пользователи могут указать аргумент шаблона для параметра шаблона Pointer, чтобы обеспечить взаимодействие с внешними функциями, принимающими Pointer*.

Поскольку все аргументы для сброса захватываются по ссылке, возвращаемый out_ptr_t должен быть временным объектом, уничтожаемым в конце полного выражения, содержащего вызов внешней функции, чтобы избежать висячих ссылок.

Пример

Использует std::out_ptr для адаптации интеллектуального указателя к sqlite3_open, которая ожидает sqlite3** в качестве выходного параметра.

#include <memory>
#include <sqlite3.h>

int main()
{
    auto close_db = [](sqlite3* db) { sqlite3_close(db); };
    
    {
        // open an in-memory database, and manage its lifetime with std::unique_ptr
        std::unique_ptr<sqlite3, decltype(close_db)> up;
        sqlite3_open(":memory:", std::out_ptr(up));
        
        sqlite3* db = up.get();
        // do something with db ...
    }
    {
        // same as above, but use a std::shared_ptr
        std::shared_ptr<sqlite3> sp;
        sqlite3_open(":memory:", std::out_ptr(sp, close_db));
        
        sqlite3* db = sp.get();
        // do something with db ...
    }
}

См. также