Espacios de nombres
Variantes
Acciones

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

De cppreference.com
< cpp‎ | container‎ | array
 
 
 
std::array
Funciones miembro
Acceso a elementos
Iteradores
Capacidad
Modificadores
Funciones no miembro
(C++20)
operator==operator!=operator<operator>operator<=operator>=operator<=>
(hasta C++20)(hasta C++20)(hasta C++20)(hasta C++20)(hasta C++20)(C++20)
Clases auxiliares
Guías de deducción(C++17)
 
Definido en el archivo de encabezado <...>
(1)
template< class T, std::size_t N >

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

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

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

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

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

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

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

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

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

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

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

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

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

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

constexpr /* véase más abajo */ operator<=>( const std::array<T, N>& lhs,

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

Compara el contenido de dos objetos array.

1-2) Comprueba el contenido de lhs y rhs es igual; es decir, tienen el mismo número de elementos y cada elemento en lhs se compara igual con el elemento en rhs en la misma posición.
3-6) Compara el contenido de lhs y rhs léxicográficamente. La comparación se realiza por una función equivalente a std::lexicographical_compare.
7) Compara el contenido de lhs y rhs léxicográficamente. La comparación se realiza como si se llamara a std::lexicographical_compare_three_way en dos objetos array con un objeto función realizando la comparación de tres vías sintetizada (véase más abajo). El tipo de retorno es el mismo que el tipo del resultado de la comparación de tres vías sintetizada.

Dados dos l-valores const E, lhs y rhs como los operadores del lado izquierdo y del lado derecho, respectivamente (donde E es T), la comparación de tres vías sintetizada se define como:

  • si std::three_way_comparable_with<E, E> se satisface, es equivalente a lhs <=> rhs;
  • de lo contrario, si comparar dos l-valores const E por el operator< está bien formado y el tipo del resultado satisface a boolean-testable, es equivalente a
lhs < rhs ? std::weak_ordering::less :
rhs < lhs ? std::weak_ordering::greater :
            std::weak_ordering::equivalent
  • de lo contrario, la comparación de tres vías sintetizada no se define, y operator<=> no participa en la resolución de sobrecarga.
El comportamiento de operator<=> está indefinido si three_way_comparable_with o boolean-testable se satisface pero no se modela, u operator< se utiliza pero E y < no establecen un orden total.

Contenido

[editar] Parámetros

lhs, rhs - Objetos array cuyo contenido hay que comparar.
-
T debe satisfacer los requisitos de EqualityComparable para poder usar las sobrecargas (1-2).
-
T debe satisfacer los requisitos de LessThanComparable para poder usar las sobrecargas (3-6). La relación de orden debe establecer un orden total.

[editar] Valor de retorno

1) true el contenido de los objetos array son iguales; de lo contrario, false.
2) true el contenido de los objetos array no son iguales; de lo contrario, false.
3) true el contenido de los/las lhs es léxicográficamente menor que el contenido de rhs; de lo contrario, false.
4) true el contenido de los/las lhs es léxicográficamente menor que o igual que el contenido de rhs; de lo contrario, false.
5) true el contenido de los/las lhs es léxicográficamente mayor que el contenido de rhs; de lo contrario, false.
6) true el contenido de los/las lhs es léxicográficamente mayor que o igual que el contenido de rhs; de lo contrario, false.
7) El orden relativo del primer par de elementos no equivalentes en lhs y rhs, si existen tales elementos; de lo contrario, lhs.size() <=> rhs.size().

[editar] Complejidad

Lineal de acuerdo al tamaño del array.

[editar] Ejemplo

#include <algorithm>
#include <iostream>
#include <...>
 
int main()
{
    std::array<int, 3> alice{1, 2, 3};
    std::array<int, 3> bob{7, 8, 9};
    std::array<int, 3> eve{1, 2, 3};
 
    std::cout << std::boolalpha;
 
    // Comparar dos contenedores desiguales
    std::cout << "alice == bob devuelve " << (alice == bob) << '\n';
    std::cout << "alice != bob devuelve " << (alice != bob) << '\n';
    std::cout << "alice <  bob devuelve " << (alice < bob) << '\n';
    std::cout << "alice <= bob devuelve " << (alice <= bob) << '\n';
    std::cout << "alice >  bob devuelve " << (alice > bob) << '\n';
    std::cout << "alice >= bob devuelve " << (alice >= bob) << '\n';
 
    std::cout << '\n';
 
    // Comparar dos contenedores desiguales
    std::cout << "alice == eve devuelve " << (alice == eve) << '\n';
    std::cout << "alice != eve devuelve " << (alice != eve) << '\n';
    std::cout << "alice <  eve devuelve " << (alice < eve) << '\n';
    std::cout << "alice <= eve devuelve " << (alice <= eve) << '\n';
    std::cout << "alice >  eve devuelve " << (alice > eve) << '\n';
    std::cout << "alice >= eve devuelve " << (alice >= eve) << '\n';
}

Salida:

alice == bob devuelve false
alice != bob devuelve true
alice <  bob devuelve true
alice <= bob devuelve true
alice >  bob devuelve false
alice >= bob devuelve false
 
alice == eve devuelve true
alice != eve devuelve false
alice <  eve devuelve false
alice <= eve devuelve true
alice >  eve devuelve false
alice >= eve devuelve true