std::experimental::ranges::exchange
From cppreference.com
 
 
 < cpp | experimental | ranges 
 
 
 C++ 
 Feature test macros (C++20)
 Concepts library (C++20)
 Metaprogramming library (C++11)
 Ranges library (C++20)
 Filesystem library (C++17)
 Concurrency support library (C++11)
 Execution control library (C++26)
Experimental 
 Filesystem library (filesystem TS)
 Library fundamentals (library fundamentals TS)
 Library fundamentals 2 (library fundamentals TS v2)
 Library fundamentals 3 (library fundamentals TS v3)
 Extensions for parallelism (parallelism TS)
 Extensions for parallelism 2 (parallelism TS v2)
 Extensions for concurrency (concurrency TS)
 Extensions for concurrency 2 (concurrency TS v2)
 Concepts (concepts TS)
 Ranges (ranges TS)
 Reflection (reflection TS)
 Mathematical special functions (special functions TR)
General utilities library 
  
 
   
 Utility components
exchange
 Function objects
 Metaprogramming and type traits
 Tagged pairs and tuples
Defined in header 
 
 
<experimental/ranges/utility> 
 template< MoveConstructible T, class U = T >
 
 (ranges TS) 
    requires Assignable<T&, U>
Replaces the value of obj with new_value and returns the old value of obj, as if by
T old_value = std::move(obj); obj = std::forward <U>(new_value); return old_value;
[edit] Parameters
 obj
 -
 object whose value to replace
 new_value
 -
 the value to assign to 
obj
[edit] Return value
The old value of obj.
[edit] Exceptions
noexcept specification:  
noexcept(std::is_nothrow_move_constructible <T>::value &&
std::is_nothrow_assignable <T&, U>::value)
std::is_nothrow_assignable <T&, U>::value)
[edit] Example
 This section is incomplete
Reason: no example
Reason: no example