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