std:: iter_swap
|
Défini dans l'en-tête
<algorithm>
|
||
|
template
<
class
ForwardIt1,
class
ForwardIt2
>
void iter_swap ( ForwardIt1 a, ForwardIt2 b ) ; |
(constexpr depuis C++20) | |
Échange les valeurs des éléments vers lesquels les itérateurs donnés pointent.
Si l'une des conditions suivantes est satisfaite, le comportement est indéfini :
- a ou b n'est pas déréférençable .
- * a n'est pas Swappable avec * b .
Table des matières |
Paramètres
| a, b | - | itérateurs vers les éléments à échanger |
| Exigences de type | ||
-
ForwardIt1, ForwardIt2
doivent satisfaire aux exigences de
LegacyForwardIterator
.
|
||
Valeur de retour
(aucun)
Complexité
Constante.
Notes
Ce modèle de fonction modélise la sémantique de l'opération d'échange définie par Swappable . C'est-à-dire que les surcharges de swap trouvées par ADL et le recours à std::swap sont pris en compte.
Implémentation possible
template<class ForwardIt1, class ForwardIt2> constexpr //< depuis C++20 void iter_swap(ForwardIt1 a, ForwardIt2 b) { using std::swap; swap(*a, *b); } |
Exemple
Ce qui suit est une implémentation du tri par sélection en C++.
#include <algorithm> #include <iostream> #include <random> #include <string_view> #include <vector> template<class ForwardIt> void selection_sort(ForwardIt begin, ForwardIt end) { for (ForwardIt it = begin; it != end; ++it) std::iter_swap(it, std::min_element(it, end)); } void println(std::string_view rem, std::vector<int> const& v) { std::cout << rem; for (int e : v) std::cout << e << ' '; std::cout << '\n'; } template<int min, int max> int rand_int() { static std::uniform_int_distribution dist(min, max); static std::mt19937 gen(std::random_device{}()); return dist(gen); } int main() { std::vector<int> v; std::generate_n(std::back_inserter(v), 20, rand_int<-9, +9>); std::cout << std::showpos; println("Before sort: ", v); selection_sort(v.begin(), v.end()); println("After sort: ", v); }
Sortie possible :
Before sort: -9 -3 +2 -8 +0 -1 +8 -4 -5 +1 -4 -5 +4 -9 -8 -6 -6 +8 -4 -6 After sort: -9 -9 -8 -8 -6 -6 -6 -5 -5 -4 -4 -4 -3 -1 +0 +1 +2 +4 +8 +8
Rapports de défauts
Les rapports de défauts modifiant le comportement suivants ont été appliqués rétroactivement aux normes C++ précédemment publiées.
| DR | Applicable à | Comportement publié | Comportement corrigé |
|---|---|---|---|
| LWG 187 | C++98 | il n'était pas spécifié si swap est utilisé | l'effet est équivalent à swap ( * a, * b ) |
Voir aussi
|
échange les valeurs de deux objets
(modèle de fonction) |
|
|
échange deux plages d'éléments
(modèle de fonction) |
|
|
(C++20)
|
échange les objets pointés par deux itérateurs sous-jacents ajustés
(modèle de fonction) |
|
(C++20)
|
échange les objets pointés par deux itérateurs sous-jacents
(modèle de fonction) |
|
(C++20)
|
échange les valeurs référencées par deux objets déréférençables
(objet de point de personnalisation) |