Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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

Zdroje