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