operator==,!=,<,<=,>,>=,<=>(std::unique_ptr) — cppreference.com

Определено в заголовочном файле `<memory>`
`template< class T1, class D1, class T2, class D2 > bool operator==( const unique_ptr<T1, D1>& x, const unique_ptr<T2, D2>& y );`	(1)	(начиная с C++11) (constexpr начиная с C++23)
`template< class T1, class D1, class T2, class D2 > bool operator!=( const unique_ptr<T1, D1>& x, const unique_ptr<T2, D2>& y );`	(2)	(начиная с C++11) (до C++20)
`template< class T1, class D1, class T2, class D2 > bool operator<( const unique_ptr<T1, D1>& x, const unique_ptr<T2, D2>& y );`	(3)	(начиная с C++11)
`template< class T1, class D1, class T2, class D2 > bool operator<=( const unique_ptr<T1, D1>& x, const unique_ptr<T2, D2>& y );`	(4)	(начиная с C++11)
`template< class T1, class D1, class T2, class D2 > bool operator>( const unique_ptr<T1, D1>& x, const unique_ptr<T2, D2>& y );`	(5)	(начиная с C++11)
`template< class T1, class D1, class T2, class D2 > bool operator>=( const unique_ptr<T1, D1>& x, const unique_ptr<T2, D2>& y );`	(6)	(начиная с C++11)
`template< class T1, class D1, class T2, class D2 > requires std::three_way_comparable_with< typename unique_ptr<T1, D1>::pointer, typename unique_ptr<T2, D2>::pointer> std::compare_three_way_result_t<typename unique_ptr<T1, D1>::pointer, typename unique_ptr<T2, D2>::pointer> operator<=>( const unique_ptr<T1, D1>& x, const unique_ptr<T2, D2>& y );`	(7)	(начиная с C++20)
`template< class T, class D > bool operator==( const unique_ptr<T, D>& x, std::nullptr_t) noexcept;`	(8)	(начиная с C++11) (constexpr начиная с C++23)
`template< class T, class D > bool operator==(std::nullptr_t, const unique_ptr<T, D>& x) noexcept;`	(9)	(начиная с C++11) (до C++20)
`template< class T, class D > bool operator!=( const unique_ptr<T, D>& x, std::nullptr_t) noexcept;`	(10)	(начиная с C++11) (до C++20)
`template< class T, class D > bool operator!=(std::nullptr_t, const unique_ptr<T, D>& x) noexcept;`	(11)	(начиная с C++11) (до C++20)
`template< class T, class D > bool operator<( const unique_ptr<T, D>& x, std::nullptr_t );`	(12)	(начиная с C++11) (constexpr начиная с C++23)
`template< class T, class D > bool operator<(std::nullptr_t, const unique_ptr<T, D>& y );`	(13)	(начиная с C++11) (constexpr начиная с C++23)
`template< class T, class D > bool operator<=( const unique_ptr<T, D>& x, std::nullptr_t );`	(14)	(начиная с C++11) (constexpr начиная с C++23)
`template< class T, class D > bool operator<=(std::nullptr_t, const unique_ptr<T, D>& y );`	(15)	(начиная с C++11) (constexpr начиная с C++23)
`template< class T, class D > bool operator>( const unique_ptr<T, D>& x, std::nullptr_t );`	(16)	(начиная с C++11) (constexpr начиная с C++23)
`template< class T, class D > bool operator>(std::nullptr_t, const unique_ptr<T, D>& y );`	(17)	(начиная с C++11) (constexpr начиная с C++23)
`template< class T, class D > bool operator>=( const unique_ptr<T, D>& x, std::nullptr_t );`	(18)	(начиная с C++11) (constexpr начиная с C++23)
`template< class T, class D > bool operator>=(std::nullptr_t, const unique_ptr<T, D>& y );`	(19)	(начиная с C++11) (constexpr начиная с C++23)
`template< class T, class D > requires std::three_way_comparable<typename unique_ptr<T, D>::pointer> std::compare_three_way_result_t<typename unique_ptr<T, D>::pointer> operator<=>( const unique_ptr<T, D>& x, std::nullptr_t );`	(20)	(начиная с C++20) (constexpr начиная с C++23)

Сравнивает значения указателя двух unique_ptr или unique_ptr и nullptr.

1-7) Сравнивает два unique_ptr

8-20) Сравнивает unique_ptr и nullptr.

Параметры

x, y — unique_ptr для сравнения

Возвращаемое значение

1) x.get() == y.get()

2) x.get() != y.get()

3) std::less<CT>()(x.get(), y.get()), где CT равно std::common_type<unique_ptr<T1, D1>::pointer, unique_ptr<T2, D2>::pointer>::type

4) !(y < x)

5) y < x

6) !(x < y)

7) std::compare_three_way{}(x.get(), y.get())

8,9) !x

10,11) (bool)x

12) std::less<unique_ptr<T,D>::pointer>()(x.get(), nullptr)

13) std::less<unique_ptr<T,D>::pointer>()(nullptr, y.get())

14) !(nullptr < x)

15) !(y < nullptr)

16) nullptr < x

17) y < nullptr

18) !(x < nullptr)

19) !(nullptr < y)

20) std::compare_three_way{}(x.get(), static_cast<typename unique_ptr<T, D>::pointer>(nullptr))

Пример

#include <iostream>
#include <memory>

int main()
{
    std::unique_ptr<int> p1(new int(42));
    std::unique_ptr<int> p2(new int(42));

    std::cout << std::boolalpha
        << "(p1 == p1)       : " << (p1 == p1) << '\n'
        << "(p1 <=> p1) == 0 : " << ((p1 <=> p1) == 0) << '\n' // Начина с C++20

    // p1 и p2 указывают на разные ячейки памяти, поэтому p1 != p2
        << "(p1 == p2)       : " << (p1 == p2) << '\n'
        << "(p1 < p2)        : " << (p1 < p2) << '\n'
        << "(p1 <=> p2) < 0  : " << ((p1 <=> p2) < 0) << '\n'   // Начина с C++20
        << "(p1 <=> p2) == 0 : " << ((p1 <=> p2) == 0) << '\n'; // Начина с C++20
}

Возможный вывод:

(p1 == p1)       : true
(p1 <=> p1) == 0 : true
(p1 == p2)       : false
(p1 < p2)        : true
(p1 <=> p2) < 0  : true
(p1 <=> p2) == 0 : false

Отчёты о дефектах

Следующие изменения поведения были применены с обратной силой к ранее опубликованным стандартам C++:

Номер	Применён	Поведение в стандарте	Корректное поведение
LWG 3426	C++20	`operator<=>(unique_ptr, nullptr_t)` некорректен	ограничения и определение зафиксированы

Смотрите также

возвращает указатель на управляемый объект
(public функция-элемент) [править]