Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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

Zdroje