Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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

Sources