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

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> <tbody class="t-dcl-rev "> </tbody><tbody> </tbody>

void swap( map& other );		(hasta C++17)
void swap( map& other ) noexcept(/* véase más abajo */);		(desde C++17)

Intercambia el contenido del contenedor con el de other. No invoca ninguna operación de movimiento, copia o intercambio en los elementos individuales.

Todos los iteradores y las referencias se mantienen válidos. Se invalida el iterador después del final.

Los objetos Compare deben ser Swappable, y se intercambian usando una llamada no-calificada a una función no miembro swap.

Si std::allocator_traits<allocator_type>::propagate_on_container_swap::value es verdadero, entonces los asignadores de memoria se intercambian usando una llamada no-calificada a una función no miembro swap. De lo contrario, no se intercambian (y si get_allocator() != other.get_allocator(), el comportamiento no está definido).

(desde C++11)

Parámetros

other

-

El contenedor con el cual intercambiar el contenido.

Valor de retorno

(Ninguno)

Excepciones

Cualquier excepción lanzada por el intercambio de los objetos Compare.	(hasta C++17)
Especificación noexcept:   (desde C++11) <tbody> </tbody> noexcept(std::allocator_traits<Allocator>::is_always_equal::value && std::is_nothrow_swappable<Compare>::value)	(desde C++17)

Complejidad

Constante.

Ejemplo

Ejecuta este código

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

// imprimir un std::pair
template <class Os, class U, class V>
Os& operator<<(Os& os, const std::pair<U, V>& p) {
    return os << p.first << ":" << p.second;
}

// imprimir un contenedor
template <class Os, class Co>
Os& operator<<(Os& os, const Co& co) {
    os << "{";
    for (auto const& i : co) { os << ' ' << i; }
    return os << " }\n";
}

int main()
{
    std::map<std::string, std::string>
        m1 { {"γ", "gama"}, {"β", "beta"}, {"α", "alfa"}, {"γ", "gama"}, },
        m2 { {"ε", "epsilon"}, {"δ", "delta"}, {"ε", "epsilon"} };

    const auto& ref = *(m1.begin());
    const auto iter = std::next(m1.cbegin());

    std::cout << "──────── antes del intercambio ────────\n"
              << "m1: " << m1 << "m2: " << m2 << "ref: " << ref
              << "\niter: " << *iter << '\n';

    m1.swap(m2);

    std::cout << "──────── después del intercambio ────────\n"
              << "m1: " << m1 << "m2: " << m2 << "ref: " << ref
              << "\niter: " << *iter << '\n';

    // Ten en cuenta que cada iterador que se refiere a un elemento en un contenedor
    // antes del intercambio se refiere al mismo elemento en otro contenedor después
    // del intercambio.  Lo mismo es verdad para las referencias.
}

Salida:

──────── antes del intercambio ────────
m1: { α:alfa β:beta γ:gama }
m2: { δ:delta ε:epsilon }
ref: α:alfa
iter: β:beta
──────── después del intercambio ────────
m1: { δ:delta ε:epsilon }
m2: { α:alfa β:beta γ:gama }
ref: α:alfa
iter: β:beta

Véase también

std::swap(std::map)

Especializa el algoritmo std::swap. (plantilla de función)