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 должен быть временным объектом, уничтожаемым в конце полной выражения, содержащего вызов внешней функции, чтобы избежать висячих ссылок.

Пример

#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 ...
    }
}

См. также