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

 

C++

Apoyo de compiladores

Implementaciones independientes y albergadas

Lenguaje

Biblioteca estándar

Encabezados de la biblioteca estándar

Requisitos denominados

Macros de prueba de característica (C++20)

Biblioteca de apoyo del lenguaje

Biblioteca de conceptos(C++20)

Biblioteca de diagnósticos

Biblioteca de gestión de memoria

Biblioteca de metaprogramación(C++11)

Biblioteca de servicios generales

Biblioteca de contenedores

Biblioteca de iteradores

Biblioteca de rangos(C++20)

Biblioteca de algoritmos

Biblioteca de cadenas

Biblioteca de procesamiento de texto

Biblioteca numérica

Biblioteca de fecha y hora

Biblioteca de entrada/salida

Biblioteca del sistema de archivos(C++17)

Biblioteca de apoyo de concurrencia(C++11)

Biblioteca de apoyo de ejecución(C++26)

Especificaciones técnicas

Índice de símbolos

Bibliotecas externas

 

Biblioteca de contenedores

De secuencias

array (C++11)

vector

vector<bool>

inplace_vector (C++26)

deque

forward_list (C++11)

list

Asociativos

set

multiset

map

multimap

Asociativos no ordenados

unordered_set (C++11)

unordered_multiset (C++11)

unordered_map (C++11)

unordered_multimap (C++11)

Adaptadores

stack

queue

priority_queue

flat_set (C++23)

flat_multiset (C++23)

flat_map (C++23)

flat_multimap (C++23)

Vistas

span (C++20)

mdspan (C++23)

Tablas

Invalidación de iteradores

Tabla de funciones miembro

Tabla de funciones no miembro

 

std::map

Funciones miembro

map::map map::~map               map::operator= map::get_allocator

Acceso a elementos map::at map::operator[] Iteradores map::beginmap::cbegin (C++11) map::endmap::cend (C++11) map::rbeginmap::crbegin (C++11)      map::rendmap::crend (C++11) Capacidad map::size map::max_size map::empty Observadores map::key_comp map::value_comp Modificadores map::clear map::insert map::erase map::swap map::extract (C++17) map::merge (C++17) map::insert_range (C++23) map::insert_or_assign (C++17) map::emplace (C++11) map::emplace_hint (C++11) map::try_emplace (C++17) Búsqueda map::count map::find map::contains (C++20) map::equal_range map::lower_bound map::upper_bound

Funciones no miembro

operator==operator<=> (C++20) std::swap(std::map) erase_if(std::map) (C++20)   operator!=operator<operator>operator<=operator>= (hasta C++20)(hasta C++20)(hasta C++20)(hasta C++20)(hasta C++20)

Guías de deducción(C++17)

 

Definido en el archivo de encabezado <...>
template<class Key, class T, class Compare, class Alloc > bool operator==(conststd::map<Key, T, Compare, Alloc>& lhs,                  conststd::map<Key, T, Compare, Alloc>& rhs );	(1)
template<class Key, class T, class Compare, class Alloc > bool operator!=(conststd::map<Key, T, Compare, Alloc>& lhs,                  conststd::map<Key, T, Compare, Alloc>& rhs );	(2)	(hasta C++20)
template<class Key, class T, class Compare, class Alloc > bool operator<(conststd::map<Key, T, Compare, Alloc>& lhs,                 conststd::map<Key, T, Compare, Alloc>& rhs );	(3)	(hasta C++20)
template<class Key, class T, class Compare, class Alloc > bool operator<=(conststd::map<Key, T, Compare, Alloc>& lhs,                  conststd::map<Key, T, Compare, Alloc>& rhs );	(4)	(hasta C++20)
template<class Key, class T, class Compare, class Alloc > bool operator>(conststd::map<Key, T, Compare, Alloc>& lhs,                 conststd::map<Key, T, Compare, Alloc>& rhs );	(5)	(hasta C++20)
template<class Key, class T, class Compare, class Alloc > bool operator>=(conststd::map<Key, T, Compare, Alloc>& lhs,                  conststd::map<Key, T, Compare, Alloc>& rhs );	(6)	(hasta C++20)
template<class Key, class T, class Compare, class Alloc > /* véase más abajo */ operator<=>(conststd::map<Key, T, Compare, Alloc>& lhs,                              conststd::map<Key, T, Compare, Alloc>& rhs );	(7)	(desde C++20)

Compara el contenido de dos objetos map.

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. Esta comparación ignora el orden Compare de map.

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 map 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. Esta comparación ignora el orden Compare de map.

Dados dos l-valores const E, lhs y rhs como los operadores del lado izquierdo y del lado derecho, respectivamente (donde E es std::pair<const Key, 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.

Parámetros

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

Valor de retorno

1)true el contenido de los objetos map son iguales; de lo contrario, false.

2)true el contenido de los objetos map 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().

Complejidad

1-2) Constante si lhs y rhs son de diferente tamaño; de lo contrario, lineal de acuerdo al tamaño del map.

3-7) Lineal de acuerdo al tamaño del map.

Ejemplo

Ejecuta este código

#include <algorithm>#include <iostream>#include <...>   int main(){std::map<int, char> alice{{1, 'a'}, {2, 'b'}, {3, 'c'}};std::map<int, char> bob{{7, 'Z'}, {8, 'Y'}, {9, 'X'}, {10, 'W'}};std::map<int, char> eve{{1, 'a'}, {2, 'b'}, {3, 'c'}};   std::cout<<std::boolalpha;   // Comparar dos contenedores desigualesstd::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 desigualesstd::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