База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C++

std::exchange: замяна на стойност с връщане на старата

std::exchange премества текущата стойност на обект в резултата, присвоява нова стойност на обекта и връща запазеното предишно състояние.

Версия: C++23

Синтаксис

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) от <utility> е еквивалентно на създаване на T old = std::move(obj), изпълнение на obj = std::forward<U>(new_value) и връщане на old. T трябва да може да се конструира чрез преместване, а T& да приема присвояване от U; шаблонът е constexpr и условно noexcept.

Полезно е за явни преходи на състояние, реализации на преместване и замяна с получаване на предишната стойност. Примерът заменя низа idle с running; резултатът е отделен низ, съдържащ idle.

Това не е атомарна операция или механизъм за синхронизация. Ако конструирането на старата стойност успее, но новото присвояване хвърли, obj вече е преместен и няма отмяна. Ако new_value е псевдоним на obj, особено като std::move(obj), може да възникне изненадващо самоприсвояване.

Примери

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

Резултат

idle running

std::exchange → idle running

Източници