std::flat_multiset<Key,Compare,KeyContainer>::erase

 

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::flat_multiset

Tipos miembro

Funciones miembro

flat_multiset::flat_multiset   flat_multiset::operator= Iteradores flat_multiset::beginflat_multiset::cbegin flat_multiset::endflat_multiset::cend flat_multiset::rbeginflat_multiset::crbegin flat_multiset::rendflat_multiset::crend Capacidad flat_multiset::size flat_multiset::max_size flat_multiset::empty Observadores flat_multiset::key_comp flat_multiset::value_comp Modificadores flat_multiset::clear flat_multiset::insert flat_multiset::insert_range flat_multiset::emplace flat_multiset::emplace_hint flat_multiset::erase flat_multiset::swap flat_multiset::extract flat_multiset::replace Búsqueda flat_multiset::count flat_multiset::find flat_multiset::contains flat_multiset::equal_range flat_multiset::lower_bound flat_multiset::upper_bound

Funciones no miembro

swap(std::flat_multiset) erase_if(std::flat_multiset)    operator==operator<=>

Clases auxiliares

uses_allocator<std::flat_multiset>

Etiquetas

sorted_equivalent         sorted_equivalent_t

Guías de deducción

 

	(1)
iterator erase( iterator pos );			(desde C++11)
iterator erase( const_iterator pos );			(desde C++11)
		(2)
iterator erase( const_iterator first, const_iterator last );				(desde C++11)
size_type erase(const Key& key );			(3)	(desde {std})
template<class K > size_type erase( K&& x );			(4)	(desde C++23)

Borra del contenedor los elementos especificados.

1) Borra el elemento en la posición pos.

2) Borra los elementos en el rango [first; last), que debe ser un rango válido en *this.

3) Borra todos los elementos con la clave equivalente a key.

4) Borra todos los elementos con la clave que se compara equivalente al valor 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, y ni iterator ni const_iterator son convertibles implícitamente de K. 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.

La información sobre la invalidación del iterador se copia de aquí

El iterador pos debe ser válido y desreferenciable. Es por esto que el iterador end() (que es válido, pero no es desreferenciable) no puede usarse como un valor para pos.

Parámetros

pos	-	Iterador al elemento a borrar.
first, last	-	Rango de elementos a borrar.
key	-	Valor de la clave de los elementos a borrar.
x	-	Un valor de cualquier tipo que se pueda comparar de forma transparente con una clave que indique los elementos a borrar.

Valor de retorno

1-2) Iterador que sigue al último elemento borrado.

3,4) Número de elementos borrados.

Excepciones

1,2) No lanza nada.

3,4) Cualquier excepción lanzada por el objeto Hash y KeyEqual.

Complejidad

Dada una instancia c de tipo flat_multiset:

1) Caso promedio: constante en el peor de los casos: c.size()

2) Caso promedio: std::distance(first, last), en el peor de los casos: c.size().

3) Caso promedio: c.count(key), en el peor de los casos: c.size().

4) Caso promedio: c.count(x), en el peor de los casos: c.size().

Informes de defectos

Los siguientes informes de defectos de cambio de comportamiento se aplicaron de manera retroactiva a los estándares de C++ publicados anteriormente.

ID	Aplicado a	Comportamiento según lo publicado	Comportamiento correcto
LWG 2059	C++11	La sobrecarga para un const_iterator introdujo una nueva ambigüedad.	Se agregó la sobrecarga para iterator.

Véase también

clear (C++23)

Borra el contenido. (función miembro pública)