std::ranges::sort_heap

template< std::random_access_iterator I, std::sentinel_for<I> S,
          class Comp = ranges::less, class Proj = std::identity >
    requires std::sortable<I, Comp, Proj>
constexpr I sort_heap( I first, S last, Comp comp = {}, Proj proj = {} );

template< ranges::random_access_range R,
          class Comp = ranges::less, class Proj = std::identity >
    requires std::sortable<ranges::iterator_t<R>, Comp, Proj>
constexpr ranges::borrowed_iterator_t<R>
    sort_heap( R&& r, Comp comp = {}, Proj proj = {} );

ソート指定された範囲の要素をcompとprojに関して、その範囲は元々ヒープをcompとprojに関して表しています。ソートされた範囲はヒープ特性を保持しません。

指定された範囲がcompとprojに関してヒープでない場合、動作は未定義です。

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

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

パラメータ

戻り値

計算量

最大で \(\scriptsize 2N \cdot \log(N)\) 2N⋅log(N) 回の comp の適用と \(\scriptsize 4N \cdot \log(N)\) 4N⋅log(N) 回の proj の適用、ここで \(\scriptsize N \) N は：

実装例

struct sort_heap_fn
{
    template<std::random_access_iterator I, std::sentinel_for<I> S,
             class Comp = ranges::less, class Proj = std::identity>
        requires std::sortable<I, Comp, Proj>
    constexpr I operator()(I first, S last, Comp comp = {}, Proj proj = {}) const
    {
        auto ret{ranges::next(first, last)};
        for (auto last{ret}; first != last; --last)
            ranges::pop_heap(first, last, comp, proj);
        return ret;
    }
    template<ranges::random_access_range R,
             class Comp = ranges::less, class Proj = std::identity>
        requires std::sortable<ranges::iterator_t<R>, Comp, Proj>
    constexpr ranges::borrowed_iterator_t<R>
        operator()(R&& r, Comp comp = {}, Proj proj = {}) const
    {
        return (*this)(ranges::begin(r), ranges::end(r), std::move(comp), std::move(proj));
    }
};
inline constexpr sort_heap_fn sort_heap{};

例

#include <algorithm>
#include <array>
#include <iostream>
void print(auto const& rem, const auto& v)
{
    std::cout << rem;
    for (const auto i : v)
        std::cout << i << ' ';
    std::cout << '\n';
}
int main()
{
    std::array v{3, 1, 4, 1, 5, 9};
    print("original array:  ", v);
    std::ranges::make_heap(v);
    print("after make_heap: ", v);
    std::ranges::sort_heap(v);
    print("after sort_heap: ", v);
}

original array:  3 1 4 1 5 9
after make_heap: 9 5 4 1 1 3
after sort_heap: 1 1 3 4 5 9

関連項目