CKTIS / C++
std::exchange: zamenjava vrednosti z vrnitvijo stare
std::exchange premakne trenutno vrednost objekta v rezultat, objektu priredi novo vrednost in vrne shranjeno prejšnje stanje.
Različica: 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> je enakovreden ustvarjanju T old = std::move(obj), izvedbi obj = std::forward<U>(new_value) in vrnitvi old. T mora biti premikalno konstruirljiv, T& pa priredljiv iz U; predloga je constexpr in pogojno noexcept.
Uporaben je za izrecne prehode stanj, izvedbe premikanja in zamenjavo s pridobitvijo prejšnje vrednosti. Primer zamenja niz idle z running; rezultat je ločen niz, ki vsebuje idle.
To ni atomska operacija ali sinhronizacijski mehanizem. Če konstrukcija stare vrednosti uspe, nova prireditev pa vrže, je bil obj že premaknjen in povrnitve ni. Če je new_value vzdevek za obj, zlasti kot std::move(obj), lahko nastane presenetljiva samoprireditev.
Primeri
#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