std::unordered_set<Key,Hash,KeyEqual,Allocator>::equal_range
De cppreference.com
< cpp | container | unordered set
| std::pair<iterator,iterator> equal_range( const Key& key ); |
(1) | (desde C++11) |
| std::pair<const_iterator,const_iterator> equal_range( const Key& key ) const; |
(2) | (desde C++11) |
| template< class K > std::pair<iterator,iterator> equal_range( const K& x ); |
(3) | (desde C++20) |
| template< class K > std::pair<const_iterator,const_iterator> equal_range( const K& x ) const; |
(4) | (desde C++20) |
1,2) Devuelve un rango que contiene todos los elementos con clave
key en el contenedor. El rango está definido por dos iteradores, el primero apunta al primer elemento del rango deseado y el segundo apunta más allá del último elemento del rango.3,4) Devuelve un rango que contiene todos los elementos del contenedor con clave equivalente a
x. Esta sobrecarga solo participa en la resolución de sobrecargas si Hash::is_transparent y KeyEqual::is_transparent son válidos y cada uno denota un tipo. Esto supone que tal Hash es invocable con el tipo K y Key, y que el KeyEqual es transparente, lo que, en conjunto, permite llamar a esta función sin construir un ejemplar de Key.Contenido |
Parámetros
| key | - | El valor de la clave con la cual comparar los elementos. |
| x | - | Un valor de cualquier tipo que se pueda comparar de forma transparente con una clave. |
Valor de retorno
Un std::pair que contiene un par de iteradores que definen el rango deseado. Si no existen tales elementos, se devuelven iteradores pasados del final (véase end()) como ambos elementos del par.
Complejidad
Lineal en el número de elementos con la clave key en el caso promedio; lineal en el tamaño del contenedor en el peor de los casos.
Ejemplo
| Esta sección está incompleta Razón: sin ejemplo |
Véase también
| (C++11) |
Encuentra un elemento con una clave específica. (función miembro pública) |
| (C++20) |
Comprueba si el contenedor contiene un elemento con una clave específica. (función miembro pública) |
| (C++11) |
Devuelve el número de elementos que coinciden con una clave específica. (función miembro pública) |
| Devuelve el rango de los elementos que coinciden con una clave específica. (plantilla de función) |
