std::shared_ptr<T>::owner_equal
template< class Y > constexpr bool owner_equal( const std::shared_ptr<Y>& other ) const noexcept; | (1) | (с C++26) |
template< class Y > constexpr bool owner_equal( const std::weak_ptr<Y>& other ) const noexcept; | (2) | (с C++26) |
Проверяет, имеют ли этот shared_ptr и other общего владельца или оба являются пустыми. Сравнение устроено так, что два умных указателя считаются эквивалентными, только если оба они пусты или владеют одним и тем же объектом, даже если значения указателей, полученных с помощью get(), различаются (например, если они указывают на разные подобъекты одного объекта).
Функция-член owner_equal задаёт отношение эквивалентности, при котором !owner_before(other) && !other.owner_before(*this) является true тогда и только тогда, когда owner_equal(other) является true.
Это упорядочение используется, чтобы можно было применять разделяемые и слабые указатели в качестве ключей в неупорядоченных ассоциативных контейнерах, обычно с помощью std::owner_equal.
Параметры
| other | - | std::shared_ptr или std::weak_ptr для сравнения |
Возвращаемое значение
true, если *this и other имеют общего владельца или оба являются пустыми. В противном случае возвращает false.
Примечания
| Макрос проверки наличия функции | Значение | Стандарт | Функция |
|---|---|---|---|
__cpp_lib_smart_ptr_owner_equality | 202306L | (C++26) | Обеспечение возможности использовать std::shared_ptr в качестве ключей в неупорядоченных ассоциативных контейнерах |
Пример
См. также
|
(C++26) | предоставляет сравнения разделяемых и слабых указателей разных типов на основе владельца (класс) |
© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/memory/shared_ptr/owner_equal