std::ranges::rotate_copy, std::ranges::rotate_copy_result
出自cppreference.com
| 在標頭 <algorithm> 定義
|
||
| 調用簽名 |
||
| template< std::forward_iterator I, std::sentinel_for<I> S, std::weakly_incrementable O > |
(1) | (C++20 起) |
| template< ranges::forward_range R, std::weakly_incrementable O > requires std::indirectly_copyable<ranges::iterator_t<R>, O> |
(2) | (C++20 起) |
| 輔助類型 |
||
| template< class I, class O > using rotate_copy_result = in_out_result<I, O>; |
(3) | (C++20 起) |
複製左旋轉 [first, last) 的結果到 result。
1) 從源範圍
[first, last) 複製元素到始於 result 的目標範圍，使得目標範圍中，[first, middle) 中的元素在 [middle, last) 後面並且保留這兩個範圍中元素的原本順序。 若
[first, middle) 或 [middle, last) 不是合法範圍，或若源與目標範圍重疊，則行為未定義。此頁面上描述的函數式實體是算法函數對象（非正式地稱為 niebloid），即：
目錄 |
[編輯] 參數
| first, last | - | 要複製的源元素範圍的迭代器-哨位對 |
| r | - | 要複製的源元素範圍 |
| middle | - | 指嚮應該出現在目標範圍起始的元素的迭代器 |
| result | - | 目標範圍的起始 |
[編輯] 返回值
{last, result + N}，其中 N = ranges::distance(first, last)。
[編輯] 複雜度
線性：準確賦值 N 次。
[編輯] 註解
若值類型為可平凡複製 (TriviallyCopyable) 且迭代器類型滿足 contiguous_iterator，則 ranges::rotate_copy 的實現通常通過使用如 std::memmove 的“大塊複製”函數避免多次賦值。
[編輯] 可能的實現
struct rotate_copy_fn { template<std::forward_iterator I, std::sentinel_for<I> S, std::weakly_incrementable O> requires std::indirectly_copyable<I, O> constexpr ranges::rotate_copy_result<I, O> operator()(I first, I middle, S last, O result) const { auto c1 {ranges::copy(middle, std::move(last), std::move(result))}; auto c2 {ranges::copy(std::move(first), std::move(middle), std::move(c1.out))}; return {std::move(c1.in), std::move(c2.out)}; } template<ranges::forward_range R, std::weakly_incrementable O> requires std::indirectly_copyable<ranges::iterator_t<R>, O> constexpr ranges::rotate_copy_result<ranges::borrowed_iterator_t<R>, O> operator()(R&& r, ranges::iterator_t<R> middle, O result) const { return (*this)(ranges::begin(r), std::move(middle), ranges::end(r), std::move(result)); } }; inline constexpr rotate_copy_fn rotate_copy {}; |
[編輯] 示例
運行此代碼
#include <algorithm> #include <iostream> #include <iterator> #include <vector> int main() { std::vector<int> src {1, 2, 3, 4, 5}; std::vector<int> dest(src.size()); auto pivot = std::ranges::find(src, 3); std::ranges::rotate_copy(src, pivot, dest.begin()); for (int i : dest) std::cout << i << ' '; std::cout << '\n'; // copy the rotation result directly to the std::cout pivot = std::ranges::find(dest, 1); std::ranges::rotate_copy(dest, pivot, std::ostream_iterator<int>(std::cout, " ")); std::cout << '\n'; }
輸出：
3 4 5 1 2 1 2 3 4 5
[編輯] 參閱
| (C++20) |
旋轉範圍中的元素順序 (算法函數對象) |
| (C++20)(C++20) |
複製範圍中元素到新位置 (算法函數對象) |
| 複製並旋轉元素範圍 (函數模板) |
