CKTIS / C++
std::swap — échanger des valeurs
std::swap, fourni par <utility>, échange les valeurs de deux objets et renvoie void. Découvrez les exigences du modèle principal, la surcharge pour les tableaux et la forme d’appel qui permet l’ADL dans le code générique.
Version : C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <utility>
std::swap(a, b);
// Generic code with argument-dependent lookup:
using std::swap;
swap(a, b);std::swap(a, b) de <utility> échange les valeurs des objets désignés par ses arguments ; la fonction renvoie void. Le modèle principal reçoit les deux arguments sous la forme T& : ils doivent donc être du même type T.
Le modèle principal exige que T satisfasse aux exigences Cpp17MoveConstructible et Cpp17MoveAssignable. Sa spécification d’exception correspond à noexcept(is_nothrow_move_constructible_v<T> && is_nothrow_move_assignable_v<T>) ; ne supposez donc pas que tout échange est sans exception.
Une surcharge distincte prend en charge les tableaux intégrés ayant le même type d’élément et la même longueur, en échangeant les éléments correspondants. Les éléments doivent pouvoir être échangés entre eux.
Dans le code générique, utilisez using std::swap; swap(a, b);. Cette forme permet aussi bien les modèles de la bibliothèque standard qu’une fonction swap trouvée par recherche dépendante des arguments (ADL). Un appel qualifié à std::swap(a, b) n’effectue pas d’ADL.
Cette fiche concerne C++23. Le projet de norme fourni est un document évolutif, et non une publication C++23 figée ; cette fiche ne garantit pas un environnement d’exécution de production.
Exemples
#include <iostream>
#include <utility>
int main() {
int a = 3;
int b = 8;
std::swap(a, b);
std::cout << a << ' ' << b << '\n';
}
Résultat
8 3
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.