<QtCompare> - Classes and helpers for defining comparison operators

함수 문서

[constexpr noexcept, since 6.7] template <typename Enum, Qt::if_enum<Enum> = true> Qt::strong_ordering compareThreeWay(Enum lhs, Enum rhs)

이 함수는 과부하된 함수입니다.

열거형 유형의 3방향 비교를 구현합니다.

이 함수는 Enum 을 기본 유형으로 변환하고 정수형에 대한 오버로드를 호출합니다.

lhs 과 rhs 사이의 관계를 나타내는 Qt::strong_ordering 의 인스턴스를 반환합니다.

이 함수는 Qt 6.7에 도입되었습니다.

[constexpr noexcept, since 6.7] template <typename FloatType, typename IntType, Qt::if_floating_point<FloatType> = true, Qt::if_integral<IntType> = true> auto compareThreeWay(FloatType lhs, IntType rhs)

이 함수는 오버로드된 함수입니다.

부동 소수점 유형과 적분 유형의 3방향 비교를 구현합니다.

이 함수는 rhs 을 FloatType 으로 변환하고 부동 소수점 유형에 대한 오버로드를 호출합니다.

lhs 과 rhs 사이의 관계를 나타내는 Qt::partial_ordering 의 인스턴스를 반환합니다. lhs 이 숫자(NaN)가 아닌 경우 Qt::partial_ordering::unordered 이 반환됩니다.

이 함수는 Qt 6.7에 도입되었습니다.

[constexpr noexcept, since 6.7] template <typename IntType, typename FloatType, Qt::if_integral<IntType> = true, Qt::if_floating_point<FloatType> = true> auto compareThreeWay(IntType lhs, FloatType rhs)

이 함수는 오버로드된 함수입니다.

적분 유형과 부동 소수점 유형의 3방향 비교를 구현합니다.

이 함수는 lhs 을 FloatType 으로 변환하고 부동 소수점 유형에 대한 오버로드를 호출합니다.

lhs 과 rhs 사이의 관계를 나타내는 Qt::partial_ordering 의 인스턴스를 반환합니다. rhs 이 숫자(NaN)가 아닌 경우 Qt::partial_ordering::unordered 이 반환됩니다.

이 함수는 Qt 6.7에 도입되었습니다.

[constexpr noexcept, since 6.7] template <typename LeftFloat, typename RightFloat, Qt::if_floating_point<LeftFloat> = true, Qt::if_floating_point<RightFloat> = true> auto compareThreeWay(LeftFloat lhs, RightFloat rhs)

이 함수는 오버로드된 함수입니다.

부동 소수점 유형의 3방향 비교를 구현합니다.

LeftFloat 및 RightFloat 이 내장 부동소수점 유형인 경우 lhs <=> rhs 을 반환합니다. operator<=>() 과 달리 이 함수 템플릿은 C++17에서도 사용할 수 있습니다. 자세한 내용은 cppreference를 참조하세요.

이 함수는 내장 타입으로 표현되는 사용자 정의 클래스의 멤버를 주문할 때 사용자 정의 compareThreeWay() 함수에서도 사용할 수 있습니다:

class MyClass {
public:
    ...
private:
    double value;
    ...
    friend Qt::partial_ordering
    compareThreeWay(const MyClass &lhs, const MyClass &rhs) noexcept
    { return Qt::compareThreeWay(lhs.value, rhs.value); }
    Q_DECLARE_PARTIALLY_ORDERED(MyClass)
};

lhs 과 rhs 사이의 관계를 나타내는 Qt::partial_ordering 의 인스턴스를 반환합니다. lhs 또는 rhs 가 숫자(NaN)가 아닌 경우 Qt::partial_ordering::unordered 가 반환됩니다.

이 함수는 Qt 6.7에 도입되었습니다.

[constexpr noexcept, since 6.7] template <typename LeftInt, typename RightInt, Qt::if_integral<LeftInt> = true, Qt::if_integral<RightInt> = true> auto compareThreeWay(LeftInt lhs, RightInt rhs)

이 함수는 과부하된 함수입니다.

적분 유형의 3방향 비교를 구현합니다.

LeftInt 및 RightInt 이 내장된 적분 유형인 경우 lhs <=> rhs 을 반환합니다. operator<=>() 와 달리 이 함수 템플릿은 C++17에서도 사용할 수 있습니다. 자세한 내용은 cppreference를 참조하세요.

이 함수는 내장형으로 표현되는 사용자 정의 클래스의 멤버를 주문할 때 사용자 정의 compareThreeWay() 함수에서도 사용할 수 있습니다:

class MyClass {
public:
    ...
private:
    int value;
    ...
    friend Qt::strong_ordering
    compareThreeWay(const MyClass &lhs, const MyClass &rhs) noexcept
    { return Qt::compareThreeWay(lhs.value, rhs.value); }
    Q_DECLARE_STRONGLY_ORDERED(MyClass)
};

lhs 과 rhs 사이의 관계를 나타내는 Qt::strong_ordering 의 인스턴스를 반환합니다.

이 함수는 Qt 6.7에 도입되었습니다.

[constexpr noexcept, since 6.8] template <typename T, typename U, Qt::if_compatible_pointers<T, U> = true> Qt::strong_ordering compareThreeWay(Qt::totally_ordered_wrapper<T *> lhs, Qt::totally_ordered_wrapper<U *> rhs)

이것은 오버로드된 함수입니다.

Qt::totally_ordered_wrapper 로 래핑된 포인터의 3방향 비교를 구현합니다. 비교를 수행할 때 포인터에 대해 엄격한 전체 순서를 사용합니다.

lhs 과 rhs 사이의 관계를 나타내는 Qt::strong_ordering 의 인스턴스를 반환합니다.

이 함수는 Qt 6.8에 도입되었습니다.

[constexpr noexcept, since 6.8] template <typename T, typename U, Qt::if_compatible_pointers<T, U> = true> Qt::strong_ordering compareThreeWay(Qt::totally_ordered_wrapper<T *> lhs, U *rhs)

이 함수는 오버로드된 함수입니다.

Qt::totally_ordered_wrapper 로 래핑된 포인터와 일반 포인터의 3방향 비교를 구현합니다. 비교를 수행할 때 포인터에 대해 엄격한 전체 순서를 사용합니다.

lhs 과 rhs 사이의 관계를 나타내는 Qt::strong_ordering 의 인스턴스를 반환합니다.

이 함수는 Qt 6.8에 도입되었습니다.

[constexpr noexcept, since 6.8] template <typename T> Qt::strong_ordering compareThreeWay(Qt::totally_ordered_wrapper<T *> lhs, std::nullptr_t rhs)

이것은 오버로드된 함수입니다.

Qt::totally_ordered_wrapper 로 래핑된 포인터와 std::nullptr_t 의 3방향 비교를 구현합니다.

lhs 과 rhs 사이의 관계를 나타내는 Qt::strong_ordering 의 인스턴스를 반환합니다.

이 함수는 Qt 6.8에 도입되었습니다.

[constexpr noexcept, since 6.8] template <typename T, typename U, Qt::if_compatible_pointers<T, U> = true> Qt::strong_ordering compareThreeWay(U *lhs, Qt::totally_ordered_wrapper<T *> rhs)

이 함수는 오버로드된 함수입니다.

일반 포인터와 Qt::totally_ordered_wrapper 로 래핑된 포인터의 3방향 비교를 구현합니다. 비교를 수행할 때 포인터에 대해 엄격한 전체 순서를 사용합니다.

lhs 과 rhs 사이의 관계를 나타내는 Qt::strong_ordering 의 인스턴스를 반환합니다.

이 함수는 Qt 6.8에 도입되었습니다.

[constexpr noexcept, since 6.8] template <typename T> Qt::strong_ordering compareThreeWay(std::nullptr_t lhs, Qt::totally_ordered_wrapper<T *> rhs)

이 함수는 오버로드된 함수입니다.

Qt::totally_ordered_wrapper 으로 래핑된 포인터로 std::nullptr_t 의 3방향 비교를 구현합니다.

lhs 과 rhs 사이의 관계를 나타내는 Qt::strong_ordering 의 인스턴스를 반환합니다.

이 함수는 Qt 6.8에 도입되었습니다.

[since 6.7] template <typename LeftType, typename RightType> auto qCompareThreeWay(const LeftType &lhs, const RightType &rhs)

lhs 와 rhs 에서 3자 비교를 수행하고 그 결과로 Qt 주문 유형 중 하나를 반환합니다. 이 함수는 C++17과 C++20 모두에서 사용할 수 있습니다.

실제 반환되는 유형은 LeftType 와 RightType 에 따라 다릅니다.

이 메서드는 다음과 같습니다.

using Qt::compareThreeWay;
return compareThreeWay(lhs, rhs);

와 같으며, 여기서 Qt::compareThreeWay 는 내장형에 대한 3자 비교의 Qt XML 구현입니다.

무료 compareThreeWay 함수는 사용자 정의 유형에 대한 3방향 비교를 제공해야 합니다. 함수는 Qt 순서 유형 중 하나를 반환해야 합니다.

Qt는 일부 유형에 대해 compareThreeWay 구현을 제공합니다.

LeftType 및 RightType 에 대해 전혀 모르는 경우 이 함수는 주로 일반 코드에서 사용하십시오.

타입을 알고 있다면, 내장 타입의 경우

• Qt::compareThreeWay 내장 타입의 경우
• compareThreeWay 사용자 정의 타입의 경우

C++20 이상으로만 컴파일되는 코드에서는 operator<=>() 을 직접 사용하십시오.

이 기능은 Qt 6.7에 도입되었습니다.

Qt::partial_ordering, Qt::weak_ordering, Qt::strong_ordering 를참조하세요 .