std::swap

 

C++

Lenguaje

Archivos de encabezado de la biblioteca estándar

Implementaciones independientes y albergadas

Requerimientos denominados

Biblioteca de soporte del lenguaje

Biblioteca de conceptos (C++20)

Biblioteca de diagnósticos

Biblioteca de utilerías

Biblioteca de cadenas

Biblioteca de contenedores

Biblioteca de iteradores

Biblioteca de rangos (C++20)

Biblioteca de algoritmos

Biblioteca numérica

Biblioteca de entrada/salida

Biblioteca de localizaciones

Biblioteca de expresiones regulares (C++11)

Biblioteca de operaciones atómicas (C++11)

Biblioteca de soporte de hilos (C++11)

Biblioteca de sistema de archivos (C++17)

Especificaciones técnicas

 

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>		(desde C++17)
	(1)
template< class T > void swap( T& a, T& b );			(hasta C++11)
template< class T > void swap( T& a, T& b ) noexcept(/* véase más abajo */);			(desde C++11) (hasta C++20)
template< class T > constexpr void swap( T& a, T& b ) noexcept(/* véase más abajo */);			(desde C++20)
		(2)
template< class T2, std::size_t N > void swap( T2 (&a)[N], T2 (&b)[N]) noexcept(/* véase más abajo */);				(desde C++11) (hasta C++20)
template< class T2, std::size_t N > constexpr void swap( T2 (&a)[N], T2 (&b)[N]) noexcept(/* véase más abajo */);				(desde C++20)

Intercambia los valores dados.

1) Intercambia los valores a y b. Esta sobrecarga no participa en la resolución de sobrecarga a menos que std::is_move_constructible_v<T> && std::is_move_assignable_v<T> sea true. (desde C++17)

2) Intercambia los arrays a y b. Efectivamente llama a std::swap_ranges(a, a+N, b). Esta sobrecarga no participa en la resolución de sobrecarga a menos que std::is_swappable_v<T2> sea true. (desde C++17)

Parámetros

a, b	-	Los valores a ser intercambiados.
Requerimientos de tipo
- T debe satisfacer los requerimientos de MoveAssignable y MoveConstructible.
- T2 debe satisfacer los requerimientos de Swappable.

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 ser especializada 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 Swappable 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)	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)	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)	Especializa el algoritmo std::swap. (plantilla de función)
std::swap(std::unordered_multimap)	Especializa el algoritmo std::swap. (plantilla de función)
std::swap(std::unordered_set)	Especializa el algoritmo std::swap. (plantilla de función)
std::swap(std::unordered_multiset)	Especializa el algoritmo std::swap. (plantilla de función)
std::swap(std::queue)	Especializa el algoritmo std::swap. (plantilla de función)
std::swap(std::priority_queue)	Especializa el algoritmo std::swap. (plantilla de función)
std::swap(std::stack)	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 the std::swap. (plantilla de función)
std::swap(std::basic_ofstream) (C++11)	Especializa el algoritmo the std::swap. (plantilla de función)
std::swap(std::basic_fstream) (C++11)	Especializa el algoritmo the 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_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::promise) (C++11)	Especializa el algoritmo std::swap. (plantilla de función)
std::swap(std::packaged_task) (C++11)	Especializa el 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)
swap(std::filesystem::path)	Intercambia dos rutas de acceso (función)

Ejemplo

Ejecuta este código

#include <algorithm>
#include <iostream>
 
int main()
{
    int a = 5, b = 3;
 
    // antes
    std::cout << a << ' ' << b << '\n';
 
    std::swap(a,b);
 
    // después
    std::cout << a << ' ' << b << '\n';
}

Salida:

5 3
3 5

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 2554	C++11	Intercambiar arrays multidimensionales nunca puede ser noexcept debido a problemas de búsqueda de nombres.	Se hizo funcionar.

Véase también

iter_swap	Intercambia los elementos a los que apuntan dos iteradores (plantilla de función)
swap_ranges	swaps dos rangos de elementos Original: swaps two ranges of elements The text has been machine-translated via Google Translate. You can help to correct and verify the translation. Click here for instructions. (plantilla de función)
exchange (C++14)	Reemplaza el argumento con un valor nuevo y devuelve su valor previo. (plantilla de función)