std::auto_ptr

 

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::auto_ptr

Memberfunktionen

auto_ptr::auto_ptr

auto_ptr::~auto_ptr

auto_ptr::operator=

auto_ptr::operator*auto_ptr::operator->

auto_ptr::get

auto_ptr::release

auto_ptr::reset

auto_ptr::operator auto_ptr<Y>auto_ptr::operator auto_ptr_ref<Y>

 

Definiert in Header <memory>
template< class T > class auto_ptr;	(1)	(in C++11 veraltet) (removed in C++17)
template<> class auto_ptr<void>;	(2)	(in C++11 veraltet) (removed in C++17)

auto_ptr ist ein Smart Pointer, der ein Objekt verwaltet, das mittels eines new-Ausdrucks erworben wurde, und dieses Objekt löscht, wenn auto_ptr selbst zerstört wird. Es kann verwendet werden, um Ausnahmesicherheit für dynamisch zugeordnete Objekte bereitzustellen, um Besitz von dynamisch zugeordneten Objekten in Funktionen zu übertragen und um dynamisch zugeordnete Objekte aus Funktionen zurückzugeben.

Das Kopieren eines auto_ptr kopiert den Zeiger und überträgt den Besitz auf das Ziel: Sowohl die Kopierkonstruktion als auch die Kopierzuweisung von auto_ptr ändern ihr rechtes Argument, und die "Kopie" ist nicht gleich dem Original. Aufgrund dieser ungewöhnlichen Kopiersemantik darf auto_ptr nicht in Standardcontainern platziert werden. Für diesen und andere Verwendungszwecke wird std::unique_ptr bevorzugt.(seit C++11)

2) Eine Spezialisierung für den Typ void wird bereitgestellt; sie deklariert die Typedef element_type, aber keine Memberfunktionen.

Eine zusätzliche Klassenvorlage auto_ptr_ref wird in der gesamten Dokumentation referenziert. Es handelt sich um einen implementierungsdefinierten Typ, der eine Referenz auf auto_ptr hält. Die Implementierung darf die Vorlage unter einem anderen Namen bereitstellen oder die Funktionen, die sie zurückgeben oder als Parameter akzeptieren, auf andere Weise implementieren.

Member types

Mitgliedertyp	Definition
element_type	T

Member functions

(Konstruktor)	erstellt einen neuen auto_ptr (public member function)
(Destruktor)	zerstört einen auto_ptr und das verwaltete Objekt (public member function)
operator=	überträgt den Besitz von einem anderen auto_ptr (public member function)
operator auto_ptr<Y>operator auto_ptr_ref<Y>	konvertiert den verwalteten Zeiger in einen Zeiger eines anderen Typs (public member function)
Observer
get	Gibt einen Zeiger auf das verwaltete Objekt zurück (public member function)
operator*operator->	greift auf das verwaltete Objekt zu (public member function)
Modifizierer
reset	Ersetzt das verwaltete Objekt (public member function)
release	gibt den Besitz des verwalteten Objekts frei (public member function)