CKTIS / C++
std::exchange: nahrazení hodnoty s vrácením původní
std::exchange přesune aktuální hodnotu objektu do výsledku, přiřadí objektu novou hodnotu a vrátí uložený původní stav.
Verze: 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) z <utility> odpovídá vytvoření T old = std::move(obj), provedení obj = std::forward<U>(new_value) a vrácení old. T musí být přesunově konstruovatelný a T& přiřaditelný z U; šablona je constexpr a podmíněně noexcept.
Hodí se pro explicitní přechody stavů, implementace přesunu a nahrazení se získáním předchozí hodnoty. Příklad nahradí řetězec idle řetězcem running; výsledkem je samostatný řetězec obsahující idle.
Nejde o atomickou operaci ani synchronizaci. Pokud konstrukce staré hodnoty uspěje, ale nové přiřazení vyhodí výjimku, z obj už bylo přesunuto a změna se nevrací. Alias new_value na obj, zejména jako std::move(obj), může vést k překvapivému sebepřiřazení.
Příklady
#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';
}
Výsledek
idle running
std::exchange → idle running