std::map<Key,T,Compare,Allocator>::insert_or_assign

See More

 

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)

 

<tbody> </tbody>

template <class M> std::pair<iterator, bool> insert_or_assign( const Key& k, M&& obj );	(1)	(desde C++17)
template <class M> std::pair<iterator, bool> insert_or_assign( Key&& k, M&& obj );	(2)	(desde C++17)
template <class M> iterator insert_or_assign( const_iterator hint, const Key& k, M&& obj );	(3)	(desde C++17)
template <class M> iterator insert_or_assign( const_iterator hint, Key&& k, M&& obj );	(4)	(desde C++17)

1,3) Si una clave equivalente a k ya existe en el contenedor, asigna std::forward<M>(obj) al mapped_type que corresponde a la clave k. Si la clave no existe, inserta un valor nuevo como si fuera por insert, construyéndolo a partir de value_type(k, std::forward<M>(obj))

2,4) Igual que (1,3), excepto que el valor asociado se construye a partir de value_type(std::move(k), std::forward<M>(obj))

El comportamiento no está definido (hasta C++20)El programa está mal formado (desde C++20) si std::is_assignable_v<mapped_type&, M&&> es false.

No se invalidan ni referencias ni iteradores.

Parámetros

k	-	La clave usada tanto para buscar como para insertar si no se encuentra.
hint	-	Iterador a la posición antes de la cual se insertará el nuevo elemento.
obj	-	El valor a insertar o asignar.

Valor de retorno

1,2) El componente bool es true si la inserción tomó lugar y false si la asignación tomó lugar. El componente iterator apunta al elemento que se insertó o actualizó.

3,4) Iterador que apunta al elemento que se insertó o actualizó.

Complejidad

1,2) La misma que para emplace.

3,4) La misma que para emplace_hint.

Notas

insert_or_assign devuelve más información que el operador operator[] y no requiere construibilidad por defecto del tipo asociado.

Ejemplo

Ejecuta este código

#include <iostream>
#include <map>
#include <string>

auto imprimir_nodo = [](const auto &nodo) {
    std::cout << "[" << nodo.first << "] = " << nodo.second << '\n';
};

auto imprimir_resultado = [](auto const &par) {
    std::cout << (par.second ? "insertado: " : "asignado:  ");
    imprimir_nodo(*par.first);
};

int main()
{
    std::map<std::string, std::string> miMapa;

    imprimir_resultado( miMapa.insert_or_assign("a", "manzana"     ) );
    imprimir_resultado( miMapa.insert_or_assign("b", "banana"      ) );
    imprimir_resultado( miMapa.insert_or_assign("c", "cereza"      ) );
    imprimir_resultado( miMapa.insert_or_assign("c", "mandarina".  ) );

    for (const auto &nodo : miMapa) { imprimir_nodo(nodo); }
}

Salida:

insertado: [a] = manzana
insertado: [b] = banana
insertado: [c] = cereza
asignado:  [c] = mandarina
[a] = manzana
[b] = banana
[c] = mandarina

Véase también

operator[]	Accede o inserta el elemento especificado. (función miembro pública)
at (C++11)	Accede al elemento especificado con comprobación de límites. (función miembro pública)
insert	Inserta elementos o nodos (desde C++17) (función miembro pública)
emplace (C++11)	Construye el elemento en el sitio. (función miembro pública)