WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::exchange: Wert ersetzen und alten zurückgeben

std::exchange verschiebt den aktuellen Objektwert in das Ergebnis, weist dem Objekt einen neuen Wert zu und liefert den gesicherten alten Zustand.

Version: C++23

Syntax

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) aus <utility> entspricht T old = std::move(obj), danach obj = std::forward<U>(new_value) und Rückgabe von old. T muss verschiebekonstruierbar und T& aus U zuweisbar sein; das Template ist constexpr und bedingt noexcept.

Dies eignet sich für explizite Zustandswechsel, Move-Implementierungen und Ersetzen mit gleichzeitiger Rückgabe des Vorwerts. Das Beispiel ersetzt den String idle durch running; das Ergebnis ist ein eigener String mit idle.

Die Operation ist weder atomar noch eine Synchronisation. Gelingt die Konstruktion des alten Werts, aber wirft die neue Zuweisung, wurde aus obj bereits verschoben und es gibt kein Rollback. Aliasierung von new_value mit obj, besonders als std::move(obj), kann überraschende Selbstzuweisung erzeugen.

Beispiele

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

Ergebnis

idle running

std::exchange → idle running

Quellen