Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::exchange: sostituire un valore e restituire il precedente

std::exchange sposta il valore corrente di un oggetto nel risultato, assegna un nuovo valore all’oggetto e restituisce il vecchio stato salvato.

Versione: C++23

Sintassi

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) di <utility> equivale a creare T old = std::move(obj), eseguire obj = std::forward<U>(new_value) e restituire old. T deve essere costruibile per spostamento e T& assegnabile da U; il template è constexpr e condizionatamente noexcept.

È utile per transizioni di stato esplicite, implementazioni di move e sostituzione recuperando il valore precedente. L’esempio sostituisce la stringa idle con running; il risultato è una stringa separata contenente idle.

Non è un’operazione atomica né un meccanismo di sincronizzazione. Se la costruzione del vecchio valore riesce ma la nuova assegnazione lancia, obj è già stato spostato e non avviene rollback. Far aliasare new_value con obj, soprattutto come std::move(obj), può causare autoassegnazione sorprendente.

Esempi

#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';
}

Risultato

idle running

std::exchange → idle running

Fonti