Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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

Izvori