CKTIS / C++
std::exchange : remplacer une valeur et renvoyer l’ancienne
std::exchange déplace la valeur courante d’un objet dans le résultat, lui affecte une nouvelle valeur et renvoie l’ancien état sauvegardé.
Version : C++23
Syntaxe
template<class T, class U = T>
constexpr T exchange(T& obj, U&& new_value)
noexcept(std::is_nothrow_move_constructible_v<T> &&
std::is_nothrow_assignable_v<T&, U>);std::exchange(obj, new_value) de <utility> équivaut à créer T old = std::move(obj), exécuter obj = std::forward<U>(new_value), puis renvoyer old. T doit être constructible par déplacement et T& affectable depuis U ; le modèle est constexpr et conditionnellement noexcept.
Il sert aux transitions d’état explicites, aux implémentations de déplacement et au remplacement avec récupération de la valeur précédente. L’exemple remplace la chaîne idle par running ; le résultat est une chaîne distincte contenant idle.
Ce n’est ni une opération atomique ni une synchronisation. Si la construction de l’ancienne valeur réussit mais que l’affectation lève, obj a déjà été déplacé et aucun retour arrière n’a lieu. Faire aliaser new_value avec obj, surtout via std::move(obj), peut produire une auto-affectation surprenante.
Exemples
#include <iostream>
#include <string>
#include <utility>
int main() {
std::string state = "idle";
const std::string old = std::exchange(state, "running");
std::cout << old << ' ' << state << '\n';
}
Résultat
idle running
std::exchange → idle running