std::is_sorted_until

ヘッダ `<algorithm>`
template< class ForwardIt > ForwardIt is_sorted_until( ForwardIt first, ForwardIt last );	で定義 (1)	(C++11 以降) (C++20 以降 constexpr)
template< class ExecutionPolicy, class ForwardIt > ForwardIt is_sorted_until( ExecutionPolicy&& policy, ForwardIt first, ForwardIt last );	(2)	(C++17 以降)
template< class ForwardIt, class Compare > ForwardIt is_sorted_until( ForwardIt first, ForwardIt last, Compare comp );	(3)	(C++11 以降) (C++20 以降 constexpr)
template< class ExecutionPolicy, class ForwardIt, class Compare > ForwardIt is_sorted_until( ExecutionPolicy&& policy, ForwardIt first, ForwardIt last, Compare comp );	(4)	(C++17 以降)

範囲 [first, last) を調べ、要素が非降順にソートされている最初の位置 first から始まる最大の範囲を探します。

1) 要素がソートされているかどうかを operator<(C++20 まで)std::less{}(C++20 以降) に関して調べ、その最大の範囲を探します。

3) 要素が comp に関してソートされているかどうかを調べ、その最大の範囲を探します。

2,4) (1,3) と同じですが、policy に従って実行されます。

これらのオーバーロードは、次の式の値が true である場合にのみオーバーロード解決に参加します:

`std::is_execution_policy_v<std::decay_t<ExecutionPolicy>>`	(C++20 まで)
`std::is_execution_policy_v<std::remove_cvref_t<ExecutionPolicy>>`	(C++20 以降)

パラメータ

first, last	-	検査する要素の範囲を定義するイテレータのペア
policy	-	使用する実行ポリシー
comp	-	比較関数オブジェクト（つまり、 Compare の要件を満たすオブジェクト）。最初の引数が2番目の引数より小さい（つまり、2番目の引数より前に順序付けられている）場合に true を返す。比較関数のシグネチャは以下と同等であるべきです： bool cmp ( const Type1 & a, const Type2 & b ) ; シグネチャが const & を持つ必要はありませんが、関数は渡されたオブジェクトを変更してはならず、値カテゴリに関係なく（したがって、 `Type1&` は許可されません、また `Type1` も、 `Type1` に対してムーブがコピーと等価でない限り許可されません (C++11以降) ）、型 `Type1` と `Type2` のすべての値を受け入れられる必要があります。型 Type1 と Type2 は、 ForwardIt 型のオブジェクトが間接参照可能で、それら両方に暗黙的に変換可能でなければなりません。
型要件
- `ForwardIt` は LegacyForwardIterator の要件を満たさなければならない。
- `Compare` は Compare の要件を満たさなければならない。

戻り値

first から始まる最大範囲の上限。つまり、範囲 [ first , it ) が昇順でソートされている最後のイテレータ it を指す。

空の範囲および長さ1の範囲に対しては last を返します。

計算量

与えられた $\scriptsize N$ $N$ を std:: distance ( first, last ) として：

1,2)

O(N)

回の比較を operator < (C++20まで) std:: less { } (C++20以降) を使用して行います。

3,4)

O(N)

回の比較関数 comp の適用。

例外

ExecutionPolicyという名前のテンプレートパラメータを持つオーバーロードは、以下のようにエラーを報告します：

アルゴリズムの一部として呼び出された関数の実行が例外をスローした場合、 ExecutionPolicy が標準ポリシーのいずれかであるとき、 std::terminate が呼び出される。その他の ExecutionPolicy については、動作は実装定義である。
アルゴリズムがメモリの確保に失敗した場合、 std::bad_alloc がスローされる。

実装例

実装例については libstdc++ および libc++ も参照してください。

is_sorted_until (1)

template<class ForwardIt>
constexpr //< since C++20
ForwardIt is_sorted_until(ForwardIt first, ForwardIt last)
{
    return std::is_sorted_until(first, last, std::less<>());
}

is_sorted_until (2)

template<class ForwardIt, class Compare>
constexpr //< since C++20
ForwardIt is_sorted_until(ForwardIt first, ForwardIt last, Compare comp)
{
    if (first != last)
    {
        ForwardIt next = first;
        while (++next != last)
        {
            if (comp(*next, *first))
                return next;
            first = next;
        }
    }
    return last;
}

例

このコードを実行

#include <algorithm>
#include <cassert>
#include <iostream>
#include <iterator>
#include <random>
#include <string>
int main()
{
    std::random_device rd;
    std::mt19937 g(rd());
    const int N = 6;
    int nums[N] = {3, 1, 4, 1, 5, 9};
    const int min_sorted_size = 4;
    for (int sorted_size = 0; sorted_size < min_sorted_size;)
    {
        std::shuffle(nums, nums + N, g);
        int *const sorted_end = std::is_sorted_until(nums, nums + N);
        sorted_size = std::distance(nums, sorted_end);
        assert(sorted_size >= 1);
        for (const auto i : nums)
            std::cout << i << ' ';
        std::cout << ": " << sorted_size << " 個の先頭ソート済み要素\n"
                  << std::string(sorted_size * 2 - 1, '^') << '\n';
    }
}

出力例:

4 1 9 5 1 3 : 1 個の先頭ソート済み要素
^
4 5 9 3 1 1 : 3 個の先頭ソート済み要素
^^^^^
9 3 1 4 5 1 : 1 個の先頭ソート済み要素
^
1 3 5 4 1 9 : 3 個の先頭ソート済み要素
^^^^^
5 9 1 1 3 4 : 2 個の先頭ソート済み要素
^^^
4 9 1 5 1 3 : 2 個の先頭ソート済み要素
^^^
1 1 4 9 5 3 : 4 個の先頭ソート済み要素
^^^^^^^

コンパイラサポート
フリースタンディングとホスト環境
言語
標準ライブラリ
標準ライブラリヘッダ
名前付き要件
機能テストマクロ (C++20)
言語サポートライブラリ
コンセプトライブラリ (C++20)
診断ライブラリ
メモリ管理ライブラリ
メタプログラミングライブラリ (C++11)
汎用ユーティリティライブラリ
コンテナライブラリ
イテレータライブラリ
レンジライブラリ (C++20)
アルゴリズムライブラリ
文字列ライブラリ
テキスト処理ライブラリ
数値ライブラリ
日付と時間ライブラリ
入出力ライブラリ
ファイルシステムライブラリ (C++17)
並行処理サポートライブラリ (C++11)
実行制御ライブラリ (C++26)
技術仕様書
シンボルインデックス
外部ライブラリ

is_sorted (C++11)	範囲がソートされているか確認する (関数テンプレートアルゴリズム関数オブジェクト)&ranges::is_sorted
(C++20) ranges::is_sorted_until	範囲がソートされているか確認する (関数テンプレートアルゴリズム関数オブジェクト)&ranges::is_sorted
(C++20) 最大のソート済み部分範囲を検索する	(アルゴリズム関数オブジェクト)

ja.cppreference.net

Namespaces

Variants

std::is_sorted_until

内容

パラメータ

戻り値

計算量

例外

実装例

例

関連項目