std::ranges::move, std::ranges::move_result
来自cppreference.com
定义于头文件 <algorithm>
|
||
调用签名 |
||
template< std::input_iterator I, std::sentinel_for<I> S, std::weakly_incrementable O > requires std::indirectly_movable<I, O> |
(1) | (C++20 起) |
template< ranges::input_range R, std::weakly_incrementable O > requires std::indirectly_movable<ranges::iterator_t<R>, O> |
(2) | (C++20 起) |
辅助类型 |
||
template< class I, class O > using move_result = ranges::in_out_result<I, O>; |
(3) | (C++20 起) |
1) 赋值
[first, last)
所定义的范围重点元素到始于 result
的另一范围。
若 result
在范围 [first, last)
内则行为未定义。此情况下可能可以用 ranges::move_backward 代替。2) 同 (1) ,但以
r
为源范围,如同以 ranges::begin(r) 为 first
并以 ranges::end(r) 为 last
。被移动的范围的元素将仍然含有适当类型的合法值,但不必为与移动前相同的值。
此页面上描述的仿函数实体是 niebloid ,即:
实际上,它们能以函数对象,或以某些特殊编译器扩展实现。
参数
first | - | 要移动的元素范围的起始 |
last | - | 要移动元素范围的末尾 |
r | - | 要移动的元素范围 |
result | - | 目标范围的起始 |
复杂度
{last, result + N} ,其中
1) N = ranges::distance(first, last) ;
2) N = ranges::distance(r) 。
复杂度
准确赋值 N 次。
注解
移动重叠的范围时, ranges::move
适合向左移动(目标范围的起始在源范围外),而 ranges::move_backward 适合向右移动(目标范围的末尾在源范围外)。
可能的实现
struct move_fn { template<std::input_iterator I, std::sentinel_for<I> S, std::weakly_incrementable O> requires std::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> requires std::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)); } }; inline constexpr move_fn move{}; |
示例
以下代码从一个容器移动线程对象(它们自身不可复制)到另一容器。
运行此代码
#include <algorithm> #include <iostream> #include <vector> #include <list> #include <iterator> #include <thread> #include <chrono> using namespace 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() 不能编译,因为 std::jthread 不可复制 std::ranges::move(v, std::back_inserter(l)); }
输出:
thread with n=400ms ended thread with n=600ms ended thread with n=800ms ended
参阅
(C++20) |
按从后往前的顺序移动某一范围的元素到新的位置 (niebloid) |
(C++20)(C++20) |
将某一范围的元素复制到一个新的位置 (niebloid) |
(C++20) |
按从后往前的顺序复制一个范围内的元素 (niebloid) |
(C++11) |
将某一范围的元素移动到一个新的位置 (函数模板) |
(C++11) |
获得右值引用 (函数模板) |