Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

std::exchange: substituir um valor e devolver o anterior

std::exchange move o valor atual de um objeto para o resultado, atribui um novo valor ao objeto e devolve o estado anterior guardado.

Versão: C++23

Sintaxe

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) de <utility> equivale a criar T old = std::move(obj), executar obj = std::forward<U>(new_value) e devolver old. T tem de ser construível por movimento e T& atribuível a partir de U; o modelo é constexpr e condicionalmente noexcept.

É útil para transições explícitas de estado, implementações de movimento e substituição com recuperação do valor anterior. O exemplo substitui a string idle por running; o resultado é outra string que contém idle.

Não é uma operação atómica nem um mecanismo de sincronização. Se a construção do valor anterior tiver êxito mas a nova atribuição lançar, obj já foi movido e não há reversão. Fazer new_value alias de obj, sobretudo como std::move(obj), pode causar autoatribuição surpreendente.

Exemplos

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

Resultado

idle running

std::exchange → idle running

Fontes