Skip to content

Search topics & cppreference

Search all study topics, concept maps, and 6,587 C++ and C reference pages.

std::experimental::ranges::exchange

Replaces the value of obj with new_value and returns the old value of obj, as if by

NotebookLM
template< MoveConstructible T, class U = T >
    requires Assignable<T&, U>
constexpr T exchange( T& obj, U&& new_val ) noexcept(/* see below */);
(ranges TS)

Replaces the value of obj with new_value and returns the old value of obj, as if by

snippet.cpp
T old_value = std::move(obj);
obj = std::forward<U>(new_value);
return old_value;

Parameters

obj - object whose value to replace
new_value - the value to assign to obj

Return value

The old value of obj.

Exceptions

noexcept specification:  
noexcept(std::is_nothrow_move_constructible<T>::value &&
         std::is_nothrow_assignable<T&, U>::value)

Example

This section is incomplete
Reason: no example

See also

(C++14)
replaces the argument with a new value and returns its previous value
(function template)

Content from this page on cppreference.com, licensed under CC-BY-SA 3.0 and GFDL. Modified: restyled, site navigation removed, code windows added. Offline snapshot of 9 February 2025.