std::out_ptr_t<Smart,Pointer,Args...>::operator Pointer*, std::out_ptr_t<Smart,Pointer,Args...>::operator void**

 

C++

Compiler-Unterstützung

Freestanding und gehostet

Sprache

Standardbibliothek

Header der Standardbibliothek

Benannte Anforderungen

Feature-Test-Makros (C++20)

Bibliothek für Sprachunterstützung

Konzepte-Bibliothek (C++20)

Diagnostik-Bibliothek

Speicherverwaltungsbibliothek

Metaprogrammierungsbibliothek (C++11)

Allgemeine Dienstprogramme-Bibliothek

Container-Bibliothek

Iterator-Bibliothek

Ranges-Bibliothek (C++20)

Algorithmen-Bibliothek

Bibliothek für Zeichenketten

Textverarbeitungsbibliothek

Numerik-Bibliothek

Datums- und Zeitbibliothek

Ein-/Ausgabe-Bibliothek

Dateisystembibliothek (C++17)

Unterstützung für nebenläufige Programmierung (C++11)

Ausführungssteuerungsbibliothek (C++26)

Technische Spezifikationen

Symbolverzeichnis

Externe Bibliotheken

 

Speicherverwaltungsbibliothek

voidify (nur Exposition*) Algorithmen für uninitialisierten Speicher uninitialized_copy uninitialized_fill uninitialized_move (C++17) uninitialized_default_construct (C++17) uninitialized_value_construct (C++17) destroy (C++17) destroy_at (C++17) uninitialized_copy_n (C++11) uninitialized_fill_n uninitialized_move_n (C++17) uninitialized_default_construct_n (C++17) uninitialized_value_construct_n (C++17) destroy_n (C++17) construct_at (C++20) Beschränkte uninitialisierte Speicher-Algorithmen ranges::uninitialized_copy (C++20) ranges::uninitialized_fill (C++20) ranges::uninitialized_move (C++20) ranges::construct_at (C++20) ranges::destroy (C++20) ranges::destroy_n (C++20) ranges::destroy_at (C++20) ranges::uninitialized_copy_n (C++20) ranges::uninitialized_fill_n (C++20) ranges::uninitialized_move_n (C++20) ranges::uninitialized_default_construct (C++20) ranges::uninitialized_value_construct (C++20) ranges::uninitialized_default_construct_n (C++20)  ranges::uninitialized_value_construct_n (C++20) C-Bibliothek malloc calloc realloc aligned_alloc (C++17) free

Allocatoren allocator allocator_traits (C++11) allocation_result (C++23) allocator_arg (C++11) uses_allocator (C++11) uses_allocator_construction_args (C++20) make_obj_using_allocator (C++20) uninitialized_construct_using_allocator (C++20)  scoped_allocator_adaptor (C++11) pmr::polymorphic_allocator (C++17) Speicherressourcen pmr::memory_resource (C++17) pmr::get_default_resource (C++17) pmr::set_default_resource (C++17) pmr::new_delete_resource (C++17) pmr::null_memory_resource (C++17) pmr::synchronized_pool_resource (C++17) pmr::unsynchronized_pool_resource (C++17) pmr::monotonic_buffer_resource (C++17) pmr::pool_options (C++17) Unterstützung für Garbage Collection declare_reachable (C++11)(bis C++23) undeclare_reachable (C++11)(bis C++23) declare_no_pointers (C++11)(bis C++23) undeclare_no_pointers (C++11)(bis C++23) pointer_safety (C++11)(bis C++23) get_pointer_safety (C++11)(bis C++23) Uninitialisierter Speicher raw_storage_iterator (bis C++20*) get_temporary_buffer (bis C++20*) return_temporary_buffer (bis C++20*) Explizites Lebenszeitmanagement start_lifetime_asstart_lifetime_as_array (C++23)(C++23)

Smarte Zeiger unique_ptr (C++11) shared_ptr (C++11) weak_ptr (C++11) auto_ptr (bis C++17*) owner_less (C++11) owner_less<void> (C++17) owner_hash (C++26) owner_equal (C++26) enable_shared_from_this (C++11) bad_weak_ptr (C++11) default_delete (C++11) out_ptr_t (C++23) inout_ptr_t (C++23) Low-Level-Speicher verwaltung operator new operator new[] operator delete operator delete[] get_new_handler (C++11) set_new_handler launder (C++17) bad_alloc bad_array_new_length (C++11) nothrow_t align_val_t (C++17) destroying_delete_t (C++20) new_handler nothrow Sonstiges pointer_traits (C++11) to_address (C++20) addressof (C++11) align (C++11) assume_aligned (C++20) is_sufficiently_aligned (C++26)

 

std::out_ptr_t

Memberfunktionen

out_ptr_t::out_ptr_t

out_ptr_t::~out_ptr_t

out_ptr_t::operator Pointer*out_ptr_t::operator void**

Nicht-Member-Funktionen

out_ptr

 

operator Pointer*() const noexcept;	(1)	(seit C++23)
operator void**() const noexcept;	(2)	(seit C++23)

Macht die Adresse eines Pointer- oder void*-Objekts für eine externe Funktion zugänglich, die es im Allgemeinen neu initialisiert.

1) Konvertiert *this in die Adresse des gespeicherten Pointer-Objekts.

2) Konvertiert *this in die Adresse eines void*-Objekts. Diese Konvertierungsfunktion nimmt nur an der Überladungsauflösung teil, wenn Pointer nicht mit void* identisch ist, und das Programm ist fehlerhaft, wenn Pointer kein Zeigertyp ist.
Der Anfangswert des void*-Objekts ist gleich dem Wert des gespeicherten Pointer-Objekts, konvertiert zu void*, und jede Änderung daran beeinflusst den Pointer-Wert, der im Destruktor verwendet wird. Der Zugriff auf das void*-Objekt außerhalb der Lebensdauer von *this hat undefiniertes Verhalten.

Sobald eine dieser beiden Konvertierungsfunktionen für ein out_ptr_t-Objekt aufgerufen wurde, darf die andere nicht mehr für dasselbe Objekt aufgerufen werden, andernfalls ist das Verhalten undefiniert.

Parameter

(keine)

Rückgabewert

1) Die Adresse des gespeicherten Pointer-Objekts.

2) Die Adresse des void*-Objekts, das die oben genannten Anforderungen erfüllt.

Anmerkungen

Wenn das Objekt, auf das der Rückgabewert zeigt, nicht überschrieben wurde, ist es gleich nullptr.

Bei gängigen Implementierungen ist die Objektrepräsentation jedes Pointer, das ein Zeigertyp ist, mit der von void* kompatibel, und daher speichern diese Implementierungen typischerweise das void*-Objekt innerhalb des Speichers für das Pointer-Objekt, es wird kein zusätzlicher Speicher benötigt.

• Wenn die Implementierung typbasierte Alias-Analyse aktiviert (was auf der Strict-Aliasing-Regel basiert), kann ein ordnungsgemäß ausgerichtetes std::byte[sizeof(void*)]-Member-Subobjekt verwendet werden, und beide Konvertierungsfunktionen geben die Adresse von Objekten zurück, die implizit erstellt wurden, innerhalb des Arrays.
• Andernfalls kann ein Pointer-Member-Subobjekt für beide Konvertierungsfunktionen verwendet werden, und (2) kann direkt dessen Adresse zurückgeben, reinterpret_cast zu void**.

Wenn Pointer ein Zeigertyp ist, dessen Objektrepräsentation mit der von void* inkompatibel ist, kann ein zusätzliches bool-Flag benötigt werden, um aufzuzeichnen, ob (1) (oder (2)) aufgerufen wurde.