std::weak_ptr<T>::owner_equal

 

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

Memberfunktionen

weak_ptr::weak_ptr

weak_ptr::~weak_ptr

weak_ptr::operator=

Modifizierer

weak_ptr::reset

weak_ptr::swap

Observer

weak_ptr::use_count

weak_ptr::expired

weak_ptr::lock

weak_ptr::owner_before

weak_ptr::owner_hash (C++26)

weak_ptr::owner_equal (C++26)

Nicht-Member-Funktionen

swap(std::weak_ptr)

Hilfsklassen

atomic<std::weak_ptr> (C++20)

Deduktionshilfen(seit C++17)

 

template< class Y > bool owner_equal( const std::weak_ptr<Y>& other ) const noexcept;	(1)	(seit C++26)
template< class Y > bool owner_equal( const std::shared_ptr<Y>& other ) const noexcept;	(2)	(seit C++26)

Prüft, ob dieser weak_ptr und other den Besitz teilen oder beide leer sind. Der Vergleich ist so gestaltet, dass zwei intelligente Zeiger nur dann als äquivalent gelten, wenn sie entweder beide leer sind oder wenn sie beide dasselbe Objekt besitzen, auch wenn die Werte der Zeiger, die durch get() erhalten werden, unterschiedlich sind (z. B. weil sie auf verschiedene Unterobjekte innerhalb desselben Objekts zeigen).

Die Member-Funktion owner_equal ist eine Äquivalenzrelation, so dass !owner_before(other) && !other.owner_before(*this) genau dann true ist, wenn owner_equal(other) true ist.

Diese Ordnung wird verwendet, um shared_ptr und weak_ptr als Schlüssel in ungeordneten assoziativen Containern nutzbar zu machen, typischerweise über std::owner_equal.

[Bearbeiten] Parameter

Sonstiges

-

der zu vergleichende std::shared_ptr oder std::weak_ptr

[Bearbeiten] Rückgabewert

true, wenn *this und other den Besitz teilen oder beide leer sind. Andernfalls wird false zurückgegeben.

[Bearbeiten] Hinweise

Feature-Test-Makro	Wert	Std	Feature
__cpp_lib_smart_ptr_owner_equality	202306L	(C++26)	Ermöglicht die Verwendung von std::weak_ptr als Schlüssel in ungeordneten assoziativen Containern

[Bearbeiten] Siehe auch

owner_equal (C++26)

ermöglicht gemischttypige, besitzerbasierte Gleichheitsvergleiche von Shared- und Weak-Zeigern (Klasse)