Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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

Viri