CKTIS / C++
std::exchange: nahradenie hodnoty s vrátením pôvodnej
std::exchange presunie aktuálnu hodnotu objektu do výsledku, priradí objektu novú hodnotu a vráti uložený pôvodný stav.
Verzia: C++23
Syntax
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> zodpovedá vytvoreniu T old = std::move(obj), vykonaniu obj = std::forward<U>(new_value) a vráteniu old. T musí byť presunovo konštruovateľný a T& priraditeľný z U; šablóna je constexpr a podmienene noexcept.
Hodí sa na explicitné prechody stavov, implementácie presunu a nahradenie so získaním predchádzajúcej hodnoty. Príklad nahradí reťazec idle reťazcom running; výsledkom je samostatný reťazec obsahujúci idle.
Nejde o atómovú operáciu ani synchronizáciu. Ak konštrukcia starej hodnoty uspeje, ale nové priradenie vyhodí výnimku, z obj už bolo presunuté a zmena sa nevracia. Alias new_value na obj, najmä ako std::move(obj), môže viesť k prekvapivému samopriradeniu.
Príklady
#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';
}
Výsledok
idle running
std::exchange → idle running