Namespaces
Variants

std:: out_ptr

From cppreference.net
C++
Memory management library
( exposition only* )
Allocators
Uninitialized memory algorithms
Constrained uninitialized memory algorithms
Memory resources
Uninitialized storage (until C++20)
( until C++20* )
( until C++20* )
( until C++20* )

Garbage collector support (until C++23)
(C++11) (until C++23)
(C++11) (until C++23)
(C++11) (until C++23)
(C++11) (until C++23)
(C++11) (until C++23)
(C++11) (until C++23)
std::out_ptr_t
Definiert im Header <memory>
template < class Pointer = void , class Smart, class ... Args >
auto out_ptr ( Smart & s, Args && ... args ) ;
(seit C++23)

Gibt einen std::out_ptr_t mit abgeleiteten Template-Argumenten zurück, der Argumente zurücksetzt und dabei Referenzen verwendet.

Das Programm ist fehlerhaft, wenn die Konstruktion des Rückgabewertes (siehe unten) fehlerhaft ist.

Inhaltsverzeichnis

Parameter

s - das Objekt (typischerweise ein Smart Pointer), das angepasst werden soll
args... - die Argumente für das Zurücksetzen, die erfasst werden sollen

Rückgabewert

std:: out_ptr_t < Smart, P, Args && > ( s, std:: forward < Args > ( args ) ... ) , wobei P ist

  • Pointer , falls Pointer kein void -Typ ist. Andernfalls,
  • Smart :: pointer , falls dieser gültig ist und einen Typ bezeichnet. Andernfalls,
  • Smart :: element_type * , falls Smart :: element_type gültig ist und einen Typ bezeichnet. Andernfalls,
  • std:: pointer_traits < Smart > :: element_type * .

Hinweise

Benutzer können das Template-Argument für den Template-Parameter Pointer angeben, um mit Fremdfunktionen zu interagieren, die einen Pointer * entgegennehmen.

Da alle Argumente für das Zurücksetzen als Referenz erfasst werden, sollte das zurückgegebene out_ptr_t ein temporäres Objekt sein, das am Ende des vollständigen Ausdrucks zerstört wird, der den Aufruf der Fremdfunktion enthält, um hängende Referenzen zu vermeiden.

Feature-Test Makro Wert Std Feature
__cpp_lib_out_ptr 202106L (C++23) std::out_ptr , std::inout_ptr
202311L (C++26) Freestanding std::out_ptr und std::inout_ptr

Beispiel

Verwenden Sie std::out_ptr , um einen Smart Pointer für sqlite3_open anzupassen, das einen sqlite3** als Out-Parameter erwartet.

Code ausführen 
#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 ...
    }
}

Siehe auch

(C++23)
erstellt einen inout_ptr_t mit einem zugehörigen Smart Pointer und Reset-Argumenten
(Funktions-Template)
(C++14) (C++20)
erstellt einen Unique Pointer, der ein neues Objekt verwaltet
(Funktions-Template)
(C++20)
erstellt einen Shared Pointer, der ein neues Objekt verwaltet
(Funktions-Template)