| Constrained algorithms and algorithms on ranges(C++20) | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Constrained algorithms, e.g.ranges::copy,ranges::sort, ... | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Execution policies(C++17) | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Numeric operations | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Operations on uninitialized memory | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
std::ranges| Non-modifying sequence operations | |||||||||||||||||||||||||||||||||
| Modifying sequence operations | |||||||||||||||||||||||||||||||||
| Partitioning operations | |||||||||||||||||||||||||||||||||
| Sorting operations | |||||||||||||||||||||||||||||||||
| Binary search operations (on sorted ranges) | |||||||||||||||||||||||||||||||||
| Set operations (on sorted ranges) | |||||||||||||||||||||||||||||||||
| Heap operations | |||||||||||||||||||||||||||||||||
| Minimum/maximum operations | |||||||||||||||||||||||||||||||||
| Permutation operations | |||||||||||||||||||||||||||||||||
| Fold operations | |||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||
| Operations on uninitialized storage | |||||||||||||||||||||||||||||||||
| Return types | |||||||||||||||||||||||||||||||||
Defined in header <algorithm> | ||
Call signature | ||
template<std::input_iterator I,std::sentinel_for<I> S,std::weakly_incrementable O> requiresstd::indirectly_movable<I, O> | (1) | (since C++20) |
template<ranges::input_range R,std::weakly_incrementable O> requiresstd::indirectly_movable<ranges::iterator_t<R>, O> | (2) | (since C++20) |
Helper types | ||
template<class I,class O> using move_result=ranges::in_out_result<I, O>; | (3) | (since C++20) |
[first, last), to another range beginning atresult.The behavior is undefined ifresult is within the range[first, last). In such a case,ranges::move_backward may be used instead.The elements in themoved-from range will still contain valid values of the appropriate type, but not necessarily the same values as before the move.
The function-like entities described on this page arealgorithm function objects (informally known asniebloids), that is:
Contents |
| first, last | - | the iterator-sentinel pair defining therange of elements to move |
| r | - | the range of the elements to move |
| result | - | the beginning of the destination range |
{last, result+ N}, where
ExactlyN move assignments.
When moving overlapping ranges,ranges::move is appropriate when moving to the left (beginning of the destination range is outside the source range) whileranges::move_backward is appropriate when moving to the right (end of the destination range is outside the source range).
struct move_fn{template<std::input_iterator I,std::sentinel_for<I> S,std::weakly_incrementable O> requiresstd::indirectly_movable<I, O>constexpr ranges::move_result<I, O> operator()(I first, S last, O result)const{for(; first!= last;++first,++result)*result=ranges::iter_move(first);return{std::move(first), std::move(result)};}template<ranges::input_range R,std::weakly_incrementable O> requiresstd::indirectly_movable<ranges::iterator_t<R>, O>constexpr ranges::move_result<ranges::borrowed_iterator_t<R>, O> operator()(R&& r, O result)const{return(*this)(ranges::begin(r),ranges::end(r), std::move(result));}}; inlineconstexpr move_fn move{}; |
The following code moves thread objects (which themselves arenon copyable) from one container to another.
#include <algorithm>#include <chrono>#include <iostream>#include <iterator>#include <list>#include <thread>#include <vector>usingnamespace std::literals::chrono_literals; void f(std::chrono::milliseconds n){std::this_thread::sleep_for(n);std::cout<<"thread with n="<< n.count()<<"ms ended"<<std::endl;} int main(){std::vector<std::jthread> v; v.emplace_back(f, 400ms); v.emplace_back(f, 600ms); v.emplace_back(f, 800ms); std::list<std::jthread> l; // std::ranges::copy() would not compile, because std::jthread is non-copyable std::ranges::move(v,std::back_inserter(l));}
Output:
thread with n=400ms endedthread with n=600ms endedthread with n=800ms ended
(C++20) | moves a range of elements to a new location in backwards order (algorithm function object)[edit] |
(C++20)(C++20) | copies a range of elements to a new location (algorithm function object)[edit] |
(C++20) | copies a range of elements in backwards order (algorithm function object)[edit] |
(C++11) | moves a range of elements to a new location (function template)[edit] |
(C++11) | converts the argument to an xvalue (function template)[edit] |
