Namensräume
Varianten
Aktionen

operator==,!=,<,<=,>,>=,<=>(std::array)

Von cppreference.com
< cpp‎ | container‎ | array

[Bearbeiten-Vorlage]
 
C++
 
Container-Bibliothek
 
std::array
 
Definiert in der Header-Datei <array>
template< class T, std::size_t N >

bool operator==( const std::array<T, N>& lhs,

                 const std::array<T, N>& rhs );
 (1) (seit C++11)
(constexpr seit C++20)
template< class T, std::size_t N >

bool operator!=( const std::array<T, N>& lhs,

                 const std::array<T, N>& rhs );
 (2) (seit C++11)
(bis C++20)
template< class T, std::size_t N >

bool operator<( const std::array<T, N>& lhs,

                const std::array<T, N>& rhs );
 (3) (seit C++11)
(bis C++20)
template< class T, std::size_t N >

bool operator<=( const std::array<T, N>& lhs,

                 const std::array<T, N>& rhs );
 (4) (seit C++11)
(bis C++20)
template< class T, std::size_t N >

bool operator>( const std::array<T, N>& lhs,

                const std::array<T, N>& rhs );
 (5) (seit C++11)
(bis C++20)
template< class T, std::size_t N >

bool operator>=( const std::array<T, N>& lhs,

                 const std::array<T, N>& rhs );
 (6) (seit C++11)
(bis C++20)
template< class T, std::size_t N >

constexpr synth-three-way-result<T>
    operator<=>( const std::array<T, N>& lhs,

                 const std::array<T, N>& rhs );
 (7) (seit C++20)

Vergleicht den Inhalt von zwei arrays.

1,2) Prüft, ob der Inhalt von lhs und rhs gleich ist, d. h. sie haben die gleiche Anzahl von Elementen und jedes Element in lhs ist mit dem Element in rhs an der gleichen Position gleich.
3-6) Vergleicht den Inhalt von lhs und rhs lexikographisch. Der Vergleich wird von einer Funktion durchgeführt, die std::lexicographical_compare entspricht.
7) Vergleicht den Inhalt von lhs und rhs lexikographisch. Der Vergleich wird so durchgeführt, als ob std::lexicographical_compare_three_way(lhs.begin(), lhs.end(),
                                                 rhs.begin(), rhs.end(), synth-three-way) aufgerufen würde.
Der Rückgabetyp ist der Rückgabetyp von synth-three-way (d. h. synth-three-way-result <T>).
Wenn keine der folgenden Bedingungen erfüllt ist, ist das Verhalten undefiniert
  • T modelliert three_way_comparable.
  • < ist für Werte des Typs (möglicherweise const-qualifiziert) T definiert, und < ist eine totale Ordnungsrelation.

Die Operatoren <, <=, >, >= und != sind synthetisiert aus operator<=> und operator== beziehungsweise.

 (seit C++20)

Inhalt

[bearbeiten] Parameter

lhs, rhs - arrays, deren Inhalt verglichen werden soll
-
T muss die Anforderungen von EqualityComparable erfüllen, um Überladungen (1,2) zu verwenden.
-
T muss die Anforderungen von LessThanComparable erfüllen, um Überladungen (3-6) zu verwenden. Die Ordnungsrelation muss eine totale Ordnung herstellen.

[bearbeiten] Rückgabewert

1) true, wenn der Inhalt der arrays gleich ist, false andernfalls.
2) true, wenn der Inhalt der arrays nicht gleich ist, false andernfalls.
3) true, wenn der Inhalt von lhs lexikographisch kleiner als der Inhalt von rhs ist, false andernfalls.
4) true, wenn der Inhalt von lhs lexikographisch kleiner oder gleich dem Inhalt von rhs ist, false andernfalls.
5) true, wenn der Inhalt von lhs lexikographisch größer als der Inhalt von rhs ist, false andernfalls.
6) true, wenn der Inhalt von lhs lexikographisch größer oder gleich dem Inhalt von rhs ist, false andernfalls.
7) Die relative Ordnung des ersten Paares nicht-gleicher Elemente in lhs und rhs, wenn solche Elemente vorhanden sind, andernfalls lhs.size() <=> rhs.size().

[bearbeiten] Komplexität

Linear zur Größe des array.

[bearbeiten] Hinweise

Die relationalen Operatoren sind in Bezug auf den `operator<` des Elementtyps definiert.

 (bis C++20)

Die relationalen Operatoren sind in Bezug auf synth-three-way definiert, der, wenn möglich, `operator<=>` und andernfalls `operator<` verwendet.

Insbesondere, wenn das Element selbst keinen `operator<=>` bereitstellt, aber implizit in einen dreiwertig vergleichbaren Typ konvertiert werden kann, wird diese Konvertierung anstelle von `operator<` verwendet.

 (seit C++20)

[bearbeiten] Beispiel

Führen Sie diesen Code aus
#include <cassert>
#include <compare>
#include <array>
 
int main()
{
    const std::array
        a{1, 2, 3},
        b{1, 2, 3},
        c{7, 8, 9};
 
    assert
    (""
        "Compare equal containers:" &&
        (a != b) == false &&
        (a == b) == true &&
        (a < b) == false &&
        (a <= b) == true &&
        (a > b) == false &&
        (a >= b) == true &&
        (a <=> b) != std::weak_ordering::less &&
        (a <=> b) != std::weak_ordering::greater &&
        (a <=> b) == std::weak_ordering::equivalent &&
        (a <=> b) >= 0 &&
        (a <=> b) <= 0 &&
        (a <=> b) == 0 &&
 
        "Compare non equal containers:" &&
        (a != c) == true &&
        (a == c) == false &&
        (a < c) == true &&
        (a <= c) == true &&
        (a > c) == false &&
        (a >= c) == false &&
        (a <=> c) == std::weak_ordering::less &&
        (a <=> c) != std::weak_ordering::equivalent &&
        (a <=> c) != std::weak_ordering::greater &&
        (a <=> c) < 0 &&
        (a <=> c) != 0 &&
        (a <=> c) <= 0 &&
    "");
}

[bearbeiten] Defect reports

Die folgenden Verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

DR angewendet auf Verhalten wie veröffentlicht Korrigiertes Verhalten
LWG 3431 C++20 operator<=> erforderte nicht, dass T
three_way_comparable modelliert.		 requires
Abgerufen von "https://cppreference.de/mwiki/index.php?title=cpp/container/array/operator_cmp&oldid=116774"