Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::exchange: zastąp wartość i zwróć poprzednią

std::exchange przenosi bieżącą wartość obiektu do wyniku, przypisuje mu nową wartość i zwraca zachowany poprzedni stan.

Wersja: C++23

Składnia

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> jest równoważne utworzeniu T old = std::move(obj), wykonaniu obj = std::forward<U>(new_value) i zwróceniu old. T musi być przenośnie konstruowalny, a T& przypisywalny z U; przeciążenie jest constexpr i ma warunkowe noexcept.

Przydaje się do jawnych przejść stanu, implementacji przenoszenia i jednoczesnego pobrania starej wartości. Przykład zastępuje napis idle napisem running; wynikiem wywołania jest oddzielny napis zawierający idle.

To nie jest operacja atomowa ani mechanizm synchronizacji. Jeśli konstrukcja starej wartości się uda, lecz przypisanie nowej rzuci, obj jest już po przeniesieniu i funkcja nie wycofuje zmiany. Aliasowanie new_value z obj, zwłaszcza std::move(obj), może prowadzić do zaskakującego samoprzypisania.

Przykłady

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

Wynik

idle running

std::exchange → idle running

Źródła