std::swap

 

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 algoritmos

Políticas de ejecución (C++17)
is_execution_policy	execution::seqexecution::parexecution::par_unseq	execution::sequenced_policyexecution::parallel_policyexecution::parallel_unsequenced_policy
Operaciones de secuencia no modificantes
all_ofany_ofnone_of (C++11)(C++11)(C++11) for_each for_each_n (C++17)	countcount_if mismatch equal adjacent_find	findfind_iffind_if_not (C++11) find_end find_first_of	search search_n lexicographical_compare lexicographical_compare_3way (C++20)
Operaciones de secuencia modificantes
copycopy_if (C++11) copy_n (C++11) copy_backward move (C++11) move_backward (C++11) transform	fill fill_n generate generate_n swap iter_swap swap_ranges sample (C++17)	removeremove_if replacereplace_if reverse rotate unique random_shuffle (hasta C++17)	remove_copyremove_copy_if replace_copyreplace_copy_if reverse_copy rotate_copy unique_copy shuffle (C++11)
Operaciones en almacenamiento no inicializado
uninitialized_copy uninitialized_move (C++17)	uninitialized_copy_n (C++11) uninitialized_move_n (C++17)	uninitialized_fill	uninitialized_fill_n
Operaciones de partición
is_partitioned (C++11) partition_point (C++11)	partition partition_copy (C++11)	stable_partition
Operaciones de ordenación
is_sorted (C++11) is_sorted_until (C++11)	sort stable_sort	partial_sort partial_sort_copy	nth_element
Operaciones de búsqueda binaria
lower_bound	upper_bound	binary_search	equal_range
Operaciones de conjuntos (en rangos ordenados)
merge inplace_merge	set_difference set_intersection	set_symmetric_difference set_union	includes
Operaciones de pila
is_heap (C++11) is_heap_until (C++11)	make_heap sort_heap	push_heap pop_heap
Operaciones mínimo/máximo
max max_element	min min_element	minmax (C++11) minmax_element (C++11)	clamp (C++17) compare_3way (C++20)
Permutaciones
is_permutation (C++11)	next_permutation	prev_permutation
Operaciones numéricas
iota (C++11) inner_product adjacent_difference	accumulate reduce (C++17) transform_reduce (C++17)	partial_sum inclusive_scan (C++17) exclusive_scan (C++17)	transform_inclusive_scan (C++17) transform_exclusive_scan (C++17)
Bibliotecas C
qsort	bsearch

 

Definido en el archivo de encabezado <algorithm>		(hasta C++11)
Definido en el archivo de encabezado <utility>		(desde C++11)
Definido en el archivo de encabezado <string_view>
template<class T > void swap( T& a, T& b );	(1)	(condicionalmente noexcept desde C++11) (constexpr desde C++20)
template<class T2, std::size_t N > void swap( T2 (&a)[N], T2 (&b)[N]);	(2)	(condicionalmente noexcept desde C++11) (constexpr desde C++20)

Intercambia los valores dados.

1) Intercambia los valores a y b.

Esta sobrecarga solo participa en la resolución de sobrecargas si std::is_move_constructible_v<T>&&std::is_move_assignable_v<T> es true.

(desde C++17)

2) Intercambia los arraysa y b. Equivalente a std::swap_ranges(a, a + N, b).

Esta sobrecarga solo participa en la resolución de sobrecargas si std::is_swappable_v<T2> is true.

(desde C++17)

Parámetros

a, b	-	Los valores a intercambiar.
Requisitos de tipo
- T debe cumplir con los requisitos de ConstruiblePorCopia y AsignablePorCopia(hasta C++11)ConstruiblePorMovimiento and AsignablePorMovimiento(desde C++11).
- T2 debe satisfacer los requisitos de Intercambiable.

Valor de retorno

(Ninguno)

Excepciones

1)

(Ninguna)	(hasta C++11)
Especificación noexcept:   (desde C++11) noexcept(     std::is_nothrow_move_constructible<T>::value&&     std::is_nothrow_move_assignable<T>::value )	(desde C++11)

2)

Especificación noexcept:   (desde C++11) noexcept(noexcept(swap(*a, *b))) La búsqueda del identificador swap en la especificación de excepción encuentra esta plantilla de función además de lo que se encuentre por las reglas de búsqueda habituales, lo que hace la especificación de excepción equivalente a C++17 std::is_nothrow_swappable.	(desde C++11) (hasta C++17)
Especificación noexcept:   (desde C++11) noexcept(std::is_nothrow_swappable_v<T2>)	(desde C++17)

Complejidad

1) Constante.

2) Lineal en N.

Especializaciones

std::swap puede especializarse en el espacio de nombres std para tipos definidos por el programa, pero tales especializaciones no se encuentran por la búsqueda dependiente de argumento (el espacio de nombres std no es el espacio de nombres asociado para los tipos definidos por el programa).

(hasta C++20)

La manera esperada de hacer intercambiable a un tipo definido por el programa es proporcionar una función no miembro swap en el mismo espacio de nombres que el tipo: véase Intercambiable para más detalles.

Las siguientes sobrecargas ya se proporcionan por la biblioteca estándar:

std::swap(std::pair) (C++11)	Especializa el algoritmo std::swap. (plantilla de función)
std::swap(std::tuple) (C++11)	Especializa el algoritmo std::swap. (plantilla de función)
std::swap(std::shared_ptr) (C++11)	Especializa el algoritmo std::swap. (plantilla de función)
std::swap(std::weak_ptr) (C++11)	Especializa el algoritmo std::swap. (plantilla de función)
std::swap(std::unique_ptr) (C++11)	Especializa el algoritmo std::swap. (plantilla de función)
std::swap(std::function) (C++11)	Especializa el algoritmo std::swap. (plantilla de función)
std::swap(std::basic_string)	Especializa el algoritmo std::swap (plantilla de función)
std::swap(std::array) (C++11)	Especializa el algoritmo std::swap. (plantilla de función)
std::swap(std::deque)	Especializa el algoritmo std::swap. (plantilla de función)
std::swap(std::forward_list) (C++11)	Especializa el algoritmo std::swap. (plantilla de función)
std::swap(std::list)	Especializa el algoritmo std::swap. (plantilla de función)
std::swap(std::vector)	Especializa el algoritmo std::swap. (plantilla de función)
std::swap(std::map)	Especializa el algoritmo std::swap. (plantilla de función)
std::swap(std::multimap)	Especializa el algoritmo std::swap. (plantilla de función)
std::swap(std::set)	Especializa el algoritmo std::swap. (plantilla de función)
std::swap(std::multiset)	Especializa el algoritmo std::swap. (plantilla de función)
std::swap(std::unordered_map) (C++11)	Especializa el algoritmo std::swap. (plantilla de función)
std::swap(std::unordered_multimap) (C++11)	Especializa el algoritmo std::swap. (plantilla de función)
std::swap(std::unordered_set) (C++11)	Especializa el algoritmo std::swap. (plantilla de función)
std::swap(std::unordered_multiset) (C++11)	Especializa el algoritmo std::swap. (plantilla de función)
std::swap(std::queue) (C++11)	Especializa el algoritmo std::swap. (plantilla de función)
std::swap(std::priority_queue) (C++11)	Especializa el algoritmo std::swap. (plantilla de función)
std::swap(std::stack) (C++11)	Especializa el algoritmo std::swap. (plantilla de función)
std::swap(std::valarray) (C++11)	Especializa el algoritmo std::swap. (plantilla de función)
std::swap(std::basic_stringbuf) (C++11)	Especializa el algoritmo std::swap. (plantilla de función)
std::swap(std::basic_istringstream) (C++11)	Especializa el algoritmo std::swap. (plantilla de función)
std::swap(std::basic_ostringstream) (C++11)	Especializa el algoritmo std::swap. (plantilla de función)
std::swap(std::basic_stringstream) (C++11)	Especializa el algoritmo std::swap. (plantilla de función)
std::swap(std::basic_filebuf) (C++11)	Especializa el algoritmo std::swap. (plantilla de función)
std::swap(std::basic_ifstream) (C++11)	Especializa el algoritmo std::swap. (plantilla de función)
std::swap(std::basic_ofstream) (C++11)	Especializa el algoritmo std::swap. (plantilla de función)
std::swap(std::basic_fstream) (C++11)	Especializa el algoritmo std::swap. (plantilla de función)
std::swap(std::basic_syncbuf) (C++20)	Especializa el algoritmo std::swap. (plantilla de función)
std::swap(std::basic_spanbuf) (C++23)	Especializa el algoritmo std::swap. (plantilla de función)
std::swap(std::basic_ispanstream) (C++23)	Especializa el algoritmo std::swap. (plantilla de función)
std::swap(std::basic_ospanstream) (C++23)	Especializa el algoritmo std::swap. (plantilla de función)
std::swap(std::basic_spanstream) (C++23)	Especializa el algoritmo std::swap. (plantilla de función)
std::swap(std::basic_regex) (C++11)	Especializa el algoritmo std::swap. (plantilla de función)
std::swap(std::match_results) (C++11)	Especializa el algoritmo std::swap. (plantilla de función)
std::swap(std::thread) (C++11)	Especializa el algoritmo std::swap. (función)
std::swap(std::unique_lock)	Especialización de std::swap para unique_lock (plantilla de función)
std::swap(std::shared_lock) (C++14)	Especialización de std::swap para shared_lock (plantilla de función)
std::swap(std::promise) (C++11)	Especializa el algoritmo std::swap. (plantilla de función)
std::swap(std::packaged_task) (C++11)	Especializa al algoritmo std::swap. (plantilla de función)
std::swap(std::optional) (C++17)	Especializa el algoritmo std::swap. (función)
std::swap(std::any) (C++17)	Especializa el algoritmo std::swap. (función)
std::swap(std::variant) (C++17)	Especializa el algoritmo std::swap. (función)
std::swap(std::basic_stacktrace) (C++23)	Especializa el algoritmo std::swap (plantilla de función)
swap(std::filesystem::path)	Intercambia dos rutas de acceso (función)
swap(std::expected) (C++23)	Especializa el algoritmo std::swap. (función)
swap(std::jthread) (C++20)	Especializa el algoritmo std::swap. (función)
swap(std::move_only_function) (C++23)	Especializa el algoritmo std::swap. (función)
swap(std::stop_source) (C++20)	Especializa el algoritmo std::swap (función)
swap(std::stop_token) (C++20)	Especializa el algoritmo std::swap (función)

Ejemplo

Ejecuta este código

#include <algorithm>#include <iostream>   namespace Ns {class A {int id {};   friendvoid swap(A& lhs, A& rhs){std::cout<<"swap("<< lhs <<", "<< rhs <<")\n"; std::swap(lhs.id, rhs.id);}   friendstd::ostream& operator<<(std::ostream& os, A const& a){return os <<"A::id="<< a.id;}   public: A(int i): id {i}{} A(A const&)= delete; A& operator =(A const&)= delete;};}   int main(){int a =5, b =3;std::cout<< a <<' '<< b <<'\n'; std::swap(a, b);std::cout<< a <<' '<< b <<'\n';   Ns::A p {6}, q {9};std::cout<< p <<' '<< q <<'\n';// std::swap(p, q); // ERROR, no se cumplen los requisitos de tipo swap(p, q);// OK, ADL encuentra la función amiga `swap` apropiadastd::cout<< p <<' '<< q <<'\n';}

Salida:

5 3 3 5 A::id=6 A::id=9 swap(A::id=6, A::id=9) A::id=9 A::id=6

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 227	C++98	No era necesario que T fuera ConstruiblePorCopia o ConstruiblePorDefecto (es posible que no se pueda construir un objeto temporal de tipo T).	También es necesario que T sea ConstruiblePorCopia.
LWG 809	C++98	No se podían intercambiar los arrays.	Se agregó una sobrecarga (2).
LWG 2554	C++11	Intercambiar arrays multidimensionales nunca podía ser noexcept debido a problemas de búsqueda de nombres.	Se hizo funcionar.

Véase también

ranges::swap (C++20)	Intercambia los valores de dos objetos. (objeto punto de personalización)
iter_swap	Intercambia los elementos a los que apuntan dos iteradores (plantilla de función)
swap_ranges	Intercambia dos rangos de elementos. (plantilla de función)
exchange (C++14)	Reemplaza el argumento con un valor nuevo y devuelve su valor previo. (plantilla de función)