std::array<T,N>:: swap
From cppreference.net
|
void
swap
(
array
&
other
)
noexcept
(
/* voir ci-dessous */
)
;
|
(depuis C++11)
(constexpr depuis C++20) |
|
Échange le contenu du conteneur avec celui de other . Ne provoque pas l'association des itérateurs et références avec l'autre conteneur.
Table des matières |
Paramètres
| autre | - | conteneur avec lequel échanger le contenu |
Valeur de retour
(aucun)
Exceptions
|
noexcept
spécification :
noexcept
(
noexcept
(
swap
(
std::
declval
<
T
&
>
(
)
,
std::
declval
<
T
&
>
(
)
)
)
)
Dans l'expression ci-dessus, l'identifiant
|
(jusqu'à C++17) |
|
noexcept
spécification :
noexcept
(
std::
is_nothrow_swappable_v
<
T
>
)
|
(depuis C++17) |
noexcept
spécification :
noexcept
Complexité
Linéaire en fonction de la taille du conteneur.
Exemple
Exécuter ce code
#include <array> #include <iostream> template<class Os, class V> Os& operator<<(Os& os, const V& v) { os << '{'; for (auto i : v) os << ' ' << i; return os << " } "; } int main() { std::array<int, 3> a1{1, 2, 3}, a2{4, 5, 6}; auto it1 = a1.begin(); auto it2 = a2.begin(); int& ref1 = a1[1]; int& ref2 = a2[1]; std::cout << a1 << a2 << *it1 << ' ' << *it2 << ' ' << ref1 << ' ' << ref2 << '\n'; a1.swap(a2); std::cout << a1 << a2 << *it1 << ' ' << *it2 << ' ' << ref1 << ' ' << ref2 << '\n'; // Notez qu'après l'échange, les itérateurs et références restent associés à leur tableau // d'origine, par exemple `it1` pointe toujours vers l'élément a1[0], `ref1` fait toujours référence à a1[1]. }
Sortie :
{ 1 2 3 } { 4 5 6 } 1 4 2 5
{ 4 5 6 } { 1 2 3 } 4 1 5 2
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 | Appliqué à | Comportement publié | Comportement corrigé |
|---|---|---|---|
| LWG 2456 | C++11 |
la spécification
noexcept
est mal formée
|
rendue fonctionnelle |
Voir aussi
|
(C++11)
|
spécialise l'algorithme
std::swap
(modèle de fonction) |