std::ranges::is_sorted_until
| ヘッダー <algorithm> で定義 |
||
| 呼び出しシグネチャ |
||
| template< std::forward_iterator I, std::sentinel_for<I> S, class Proj = std::identity, |
(1) | (C++20以降) |
| template< std::forward_range R, class Proj = std::identity, std::indirect_strict_weak_order< |
(2) | (C++20以降) |
範囲[first, last) を調べ、first から始まる、要素が非降順でソートされている最大の範囲を見つけます。
シーケンスは、比較関数 comp に関してソートされているとは、シーケンスを指す任意のイテレータ it と、シーケンスの要素を指す有効なイテレータとなる非負整数 n に対して、std::invoke(comp, std::invoke(proj, *(it + n)), std::invoke(proj, *it)) が false と評価される場合です。
このページで説明されている関数のようなエンティティは、アルゴリズム関数オブジェクト（非公式にはニーブロイドとして知られている）です。つまり、
- これらのいずれかを呼び出す際に、明示的なテンプレート引数リストを指定することはできません。
- これらのいずれも実引数依存の名前探索には見えません。
- これらのいずれかが関数呼び出し演算子の左側の名前として通常の非修飾名探索によって見つかった場合、実引数依存の名前探索は抑制されます。
目次 |
[編集] パラメータ
| first, last | - | ソートされた上限を見つける範囲を定義するイテレータ-センチネルペア |
| r | - | ソートされた上限を見つける範囲 |
| comp | - | 射影された要素に適用する比較関数 |
| proj | - | 要素に適用する射影 |
[編集] 戻り値
first から始まる、要素が非降順でソートされている最大の範囲の上限。つまり、範囲 [first, it) がソートされているような、最後のイテレータ it。
[編集] 計算量
first と last の距離に対して線形。
[編集] 実装例
struct is_sorted_until_fn { template<std::forward_iterator I, std::sentinel_for<I> S, class Proj = std::identity, std::indirect_strict_weak_order<std::projected<I, Proj>> Comp = ranges::less> constexpr I operator()(I first, S last, Comp comp = {}, Proj proj = {}) const { if (first == last) return first; for (auto next = first; ++next != last; first = next) if (std::invoke(comp, std::invoke(proj, *next), std::invoke(proj, *first))) return next; return first; } template<ranges::forward_range R, class Proj = std::identity, std::indirect_strict_weak_order< std::projected<ranges::iterator_t<R>, Proj>> Comp = ranges::less> constexpr ranges::borrowed_iterator_t<R> operator()(R&& r, Comp comp = {}, Proj proj = {}) const { return (*this)(ranges::begin(r), ranges::end(r), std::ref(comp), std::ref(proj)); } }; inline constexpr is_sorted_until_fn is_sorted_until; |
[編集] 注意
空の範囲および長さ 1 の範囲に対して、ranges::is_sorted_until は last と等しいイテレータを返します。
[編集] 例
#include <array> #include <algorithm> #include <iostream> #include <iterator> #include <random> int main() { std::random_device rd; std::mt19937 g {rd()}; std::array nums {3, 1, 4, 1, 5, 9}; constexpr int min_sorted_size = 4; int sorted_size = 0; do { std::ranges::shuffle(nums, g); const auto sorted_end = std::ranges::is_sorted_until(nums); sorted_size = std::ranges::distance(nums.begin(), sorted_end); std::ranges::copy(nums, std::ostream_iterator<int>(std::cout, " ")); std::cout << " : " << sorted_size << " leading sorted element(s)\n"; } while (sorted_size < min_sorted_size); }
実行結果の例
4 1 9 5 1 3 : 1 leading sorted element(s) 4 5 9 3 1 1 : 3 leading sorted element(s) 9 3 1 4 5 1 : 1 leading sorted element(s) 1 3 5 4 1 9 : 3 leading sorted element(s) 5 9 1 1 3 4 : 2 leading sorted element(s) 4 9 1 5 1 3 : 2 leading sorted element(s) 1 1 4 9 5 3 : 4 leading sorted element(s)
[編集] 関連項目
| (C++20) |
範囲が昇順にソートされているかどうかをチェックする (アルゴリズム関数オブジェクト) |
| (C++11) |
ソートされている最大のサブ範囲を見つける (関数テンプレート) |
