std::ranges:: lexicographical_compare

From cppreference.net

定義先ヘッダ `<algorithm>`
呼び出しシグネチャ
template < std:: input_iterator I1, std:: sentinel_for < I1 > S1, std:: input_iterator I2, std:: sentinel_for < I2 > S2, class Proj1 = std:: identity , class Proj2 = std:: identity , std:: indirect_strict_weak_order < std :: projected < I1, Proj1 > , std :: projected < I2, Proj2 >> Comp = ranges:: less > constexpr bool lexicographical_compare ( I1 first1, S1 last1, I2 first2, S2 last2, Comp comp = { } , Proj1 proj1 = { } , Proj2 proj2 = { } ) ;	(1)	(C++20以降)
template < ranges:: input_range R1, ranges:: input_range R2, class Proj1 = std:: identity , class Proj2 = std:: identity , std:: indirect_strict_weak_order < std :: projected < ranges:: iterator_t < R1 > , Proj1 > , std :: projected < ranges:: iterator_t < R2 > , Proj2 >> Comp = ranges:: less > constexpr bool lexicographical_compare ( R1 && r1, R2 && r2, Comp comp = { } , Proj1 proj1 = { } , Proj2 proj2 = { } ) ;	(2)	(C++20以降)

最初の範囲 [ first1 , last1 ) が2番目の範囲 [ first2 , last2 ) より辞書順で 小さい かどうかをチェックします。

1) 要素は指定された二項比較関数 comp を使用して比較されます。

2) (1) と同じですが、 r をソース範囲として使用します。これは ranges:: begin ( r ) を first として、 ranges:: end ( r ) を last として使用する場合と同様です。

辞書順比較は以下の特性を持つ操作です：

2つの範囲が要素ごとに比較されます。
最初に不一致となる要素によって、どちらの範囲が辞書順で less または greater であるかが定義されます。
一方の範囲が他方の接頭辞である場合、短い方の範囲が辞書順で less となります。
2つの範囲が同等の要素を持ち、同じ長さである場合、それらの範囲は辞書順で equal となります。
空の範囲は、あらゆる非空の範囲に対して辞書順で less となります。
2つの空の範囲は辞書順で equal となります。

このページで説明されている関数ライクなエンティティは、 アルゴリズム関数オブジェクト （非公式には niebloids として知られる）です。すなわち：

明示的なテンプレート引数リストは、いずれかを呼び出す際に指定することはできません。
いずれも実引数依存の名前探索では可視になりません。
いずれかが関数呼び出し演算子の左側の名前として通常の非修飾名前探索によって見つかった場合、実引数依存の名前探索は抑制されます。

first1, last1	-	検査対象の最初の要素範囲を定義する範囲を表すイテレータ-番兵ペア
r1	-	検査対象の最初の要素範囲
first2, last2	-	検査対象の2番目の要素範囲を定義する範囲を表すイテレータ-番兵ペア
r2	-	検査対象の2番目の要素範囲
comp	-	投影された要素に適用する比較関数
proj1	-	最初の要素範囲に適用する投影
proj2	-	2番目の要素範囲に適用する投影

戻り値

true 最初の範囲が2番目の範囲より辞書順で 小さい 場合。

計算量

最大で $2\cdotmin(N1, N2)$ 回の比較および対応する射影の適用。ここで N1 = ranges:: distance ( first1, last1 ) および N2 = ranges:: distance ( first2, last2 ) である。

実装例

struct lexicographical_compare_fn
{
    template<std::input_iterator I1, std::sentinel_for<I1> S1,
             std::input_iterator I2, std::sentinel_for<I2> S2,
             class Proj1 = std::identity, class Proj2 = std::identity,
             std::indirect_strict_weak_order<
                 std::projected<I1, Proj1>,
                 std::projected<I2, Proj2>> Comp = ranges::less>
    constexpr bool operator()(I1 first1, S1 last1, I2 first2, S2 last2,
                              Comp comp = {}, Proj1 proj1 = {}, Proj2 proj2 = {}) const
    {
        for (; (first1 != last1) && (first2 != last2); ++first1, (void) ++first2)
        {
            if (std::invoke(comp, std::invoke(proj1, *first1), std::invoke(proj2, *first2)))
                return true;
            if (std::invoke(comp, std::invoke(proj2, *first2), std::invoke(proj1, *first1)))
                return false;
        }
        return (first1 == last1) && (first2 != last2);
    }
    template<ranges::input_range R1, ranges::input_range R2,
             class Proj1 = std::identity, class Proj2 = std::identity,
             std::indirect_strict_weak_order<
                 std::projected<ranges::iterator_t<R1>, Proj1>,
                 std::projected<ranges::iterator_t<R2>, Proj2>> Comp = ranges::less>
    constexpr bool operator()(R1&& r1, R2&& r2, Comp comp = {},
                              Proj1 proj1 = {}, Proj2 proj2 = {}) const
    {
        return (*this)(ranges::begin(r1), ranges::end(r1),
                       ranges::begin(r2), ranges::end(r2),
                       std::ref(comp), std::ref(proj1), std::ref(proj2));
    }
};
inline constexpr lexicographical_compare_fn lexicographical_compare;

例

このコードを実行

#include <algorithm>
#include <iostream>
#include <iterator>
#include <random>
#include <vector>
int main()
{
    std::vector<char> v1 {'a', 'b', 'c', 'd'};
    std::vector<char> v2 {'a', 'b', 'c', 'd'};
    namespace ranges = std::ranges;
    auto os = std::ostream_iterator<char>(std::cout, " ");
    std::mt19937 g {std::random_device {}()};
    while (not ranges::lexicographical_compare(v1, v2))
    {
        ranges::copy(v1, os);
        std::cout << ">= ";
        ranges::copy(v2, os);
        std::cout << '\n';
        ranges::shuffle(v1, g);
        ranges::shuffle(v2, g);
    }
    ranges::copy(v1, os);
    std::cout << "<  ";
    ranges::copy(v2, os);
    std::cout << '\n';
}

出力例:

a b c d >= a b c d
d a b c >= c b d a
b d a c >= a d c b
a c d b <  c d a b

Compiler support
Freestanding and hosted
Language
Standard library
Standard library headers
Named requirements
Feature test macros (C++20)
Language support library
Concepts library (C++20)
Diagnostics library
Memory management library
Metaprogramming library (C++11)
General utilities library
Containers library
Iterators library
Ranges library (C++20)
Algorithms library
Strings library
Text processing library
Numerics library
Date and time library
Input/output library
Filesystem library (C++17)
Concurrency support library (C++11)
Execution control library (C++26)
Technical specifications
Symbols index
External libraries

ranges::equal (C++20)	2つの要素セットが同じかどうかを判定する (アルゴリズム関数オブジェクト)
lexicographical_compare	一方の範囲が他方よりも辞書順で小さい場合に true を返す (関数テンプレート)

cppreference.net

Namespaces

Variants

std::ranges:: lexicographical_compare

目次

パラメータ

戻り値

計算量

実装例

例

関連項目