CKTIS / C++
std::exchange: zamjena vrijednosti uz povrat stare
std::exchange premješta trenutačnu vrijednost objekta u rezultat, objektu dodjeljuje novu vrijednost i vraća spremljeno prethodno stanje.
Verzija: C++23
Sintaksa
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) iz <utility> jednak je stvaranju T old = std::move(obj), izvođenju obj = std::forward<U>(new_value) i vraćanju old. T mora biti pomično konstruirljiv, a T& dodjeljiv iz U; predložak je constexpr i uvjetno noexcept.
Koristan je za izričite prijelaze stanja, implementacije premještanja i zamjenu uz dohvat prethodne vrijednosti. Primjer zamjenjuje string idle s running; rezultat je zaseban string koji sadrži idle.
To nije atomska operacija ni sinkronizacijski mehanizam. Ako konstrukcija stare vrijednosti uspije, ali nova dodjela baci, obj je već premješten i nema vraćanja. Ako new_value aliasira obj, osobito kao std::move(obj), može nastati iznenađujuća samododjela.
Primjeri
#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';
}
Rezultat
idle running
std::exchange → idle running