std::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)

 

Definiert in Header <memory>
struct owner_equal;		(seit C++26)

Dieses Funktions-Objekt stellt eine besitzerbasierte (im Gegensatz zu einer wertbasierten) gemischte Gleichheitsprüfung sowohl für std::weak_ptr als auch für std::shared_ptr bereit. Die Prüfung ist so gestaltet, dass zwei intelligente Zeiger nur dann als äquivalent gelten, wenn sie beide leer sind oder wenn sie sich den Besitz teilen, selbst wenn die Werte der durch get() erhaltenen Rohzeiger unterschiedlich sind (z.B. weil sie auf verschiedene Unterobjekte desselben Objekts zeigen).

1) Besitzerbasierte gemischte Gleichheitsprüfung wird für andere Typen als std::shared_ptr und std::weak_ptr nicht bereitgestellt.

2) Die besitzerbasierte gemischte Gleichheitsprüfung von std::shared_ptr und std::weak_ptr.

Es ist das bevorzugte Vergleichsprädikat beim Aufbau von ungeordneten assoziativen Containern mit std::shared_ptr und std::weak_ptr als Schlüssel zusammen mit std::owner_hash, d.h. std::unordered_map<std::shared_ptr<T>, U, std::owner_hash, std::owner_equal> oder std::unordered_map<std::weak_ptr<T>, U, std::owner_hash, std::owner_equal>.

3) std::owner_equal leitet die Parametertypen von den Argumenten ab.

Verschachtelte Typen

Verschachtelter Typ	Definition
is_transparent	nicht spezifiziert

Member-Funktionen

operator()

vergleicht seine Argumente anhand von inhaltsbasierten Semantiken (Funktion)

std::owner_equal::operator()

template< class T, class U > bool operator()( const std::shared_ptr<T>& lhs,                  const std::shared_ptr<U>& rhs ) const noexcept;		(seit C++26)
template< class T, class U > bool operator()( const std::shared_ptr<T>& lhs,                  const std::weak_ptr<U>& rhs ) const noexcept;		(seit C++26)
template< class T, class U > bool operator()( const std::weak_ptr<T>& lhs,                  const std::shared_ptr<U>& rhs ) const noexcept;		(seit C++26)
template< class T, class U > bool operator()( const std::weak_ptr<T>& lhs,                  const std::weak_ptr<U>& rhs ) const noexcept;		(seit C++26)

Vergleicht lhs und rhs unter Verwendung besitzerbasierter Semantik. Ruft effektiv lhs.owner_equal(rhs) auf.

Die Gleichheitsprüfung ist eine Äquivalenzrelation.

lhs und rhs sind nur dann äquivalent, wenn sie beide leer sind oder sich den Besitz teilen.

Parameter

lhs, rhs

-

geteilte Besitzzeiger zum Vergleichen

Rückgabewert

true, wenn lhs und rhs beide leer sind oder den Besitz wie durch die besitzerbasierte Gleichheitsprüfung bestimmt teilen, andernfalls false.

Anmerkungen

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

Siehe auch

owner_equal (C++26)	stellt besitzerbasierte Gleichheitsprüfung für Shared Pointers bereit (public member function of std::shared_ptr<T>)
owner_equal (C++26)	stellt besitzerbasierte Gleichheitsprüfung für Weak Pointers bereit (public member function of std::weak_ptr<T>)