std:: out_ptr_t

out_ptr_t wird verwendet, um Typen wie Smart Pointer für Fremdfunktionen anzupassen, die ihre Ergebnisse über einen Pointer* (üblicherweise T** für einen Objekttyp T ) oder einen void ** -Parameter ausgeben.

out_ptr_t erfasst bei der Konstruktion zusätzliche Argumente, stellt Speicher für das Ergebnis bereit, in das die erwähnte Fremdfunktion schreibt, und setzt schließlich das angepasste Smart -Objekt mit dem Ergebnis und den erfassten Argumenten zurück, wenn es zerstört wird.

out_ptr_t verhält sich, als ob es die folgenden nicht-statischen Datenelemente enthält:

• eine Smart& -Referenz, die bei der Konstruktion an das angepasste Objekt gebunden wird,
• für jedes T in Args... , ein Member vom Typ T , der bei der Konstruktion erfasst wird und beim Destruieren für das Zurücksetzen verwendet wird, und
• ein Member-Subobjekt, das geeignet ist, einen Pointer darin zu speichern und ein void * -Objekt bereitzustellen, wobei der Pointer oder das void * -Objekt typischerweise einer Fremdfunktion zur Reinitialisierung übergeben wird.

Benutzer können steuern, ob jedes Argument für das Zurücksetzen durch Kopie oder durch Referenz erfasst wird, indem sie einen Objekttyp oder einen Referenztyp in Args... angeben.

Template-Parameter

Spezialisierungen

Im Gegensatz zu den meisten Klassentemplates in der Standardbibliothek müssen programmdefinierte Spezialisierungen von out_ptr_t , die von mindestens einem programmdefinierten Typ abhängen, nicht die Anforderungen der Primärvorlage erfüllen.

Diese Lizenz erlaubt einer programmdefinierten Spezialisierung, den rohen Zeiger, der in einem nicht-standardmäßigen Smart Pointer gespeichert ist, für externe Funktionen verfügbar zu machen.

Memberfunktionen

Nicht-Member-Funktionen

Hinweise

out_ptr_t erwartet, dass die Fremdfunktionen den Wert des gezeigten Pointer nicht verwenden und ihn nur neu initialisieren. Der Wert des Smart Pointers vor der Anpassung wird nicht verwendet.

Die typische Verwendung von out_ptr_t besteht darin, temporäre Objekte durch std::out_ptr zu erstellen, die den angepassten Smart Pointer sofort zurücksetzen. Zum Beispiel, gegeben eine Setter-Funktion und einen Smart Pointer des entsprechenden Typs, deklariert mit int foreign_setter ( T ** ) ; und std:: unique_ptr < T, D > up ; jeweils,

int foreign_setter(T**);
std::unique_ptr<T, D> up;
if (int ec = foreign_setter(std::out_ptr(up)))
    return ec;

entspricht in etwa

int foreign_setter(T**);
std::unique_ptr<T, D> up;
T* raw_p{};
int ec = foreign_setter(&raw_p);
up.reset(raw_p);
if (ec != 0)
    return ec;

` Tags wurde gemäß den Anweisungen nicht übersetzt, da es sich um C++-Code handelt. Die HTML-Struktur und Attribute bleiben ebenfalls unverändert.

Es wird nicht empfohlen, ein out_ptr_t -Objekt mit einer anderen Speicherdauer als der automatischen Speicherdauer zu erstellen, da solcher Code wahrscheinlich hängende Referenzen erzeugt und bei der Zerstörung zu undefiniertem Verhalten führt.

out_ptr_t verbietet die Verwendung, die einen std::shared_ptr ohne Angabe eines Deleters zurücksetzen würde, da dies std::shared_ptr::reset aufrufen und einen benutzerdefinierten Deleter später ersetzen würde.

Erfasste Argumente werden typischerweise in ein std:: tuple < Args... > gepackt. Implementierungen können verschiedene Mechanismen verwenden, um das Pointer - oder void * -Objekt bereitzustellen, das sie halten müssen.

Beispiel

Siehe auch