Namespaces
Variants

std:: is_heap_until

From cppreference.net
Algorithm library
Constrained algorithms and algorithms on ranges (C++20)
Constrained algorithms, e.g. ranges::copy , ranges::sort , ...
Execution policies (C++17)
Non-modifying sequence operations
Batch operations
(C++17)
Search operations
Modifying sequence operations
Copy operations
(C++11)
(C++11)
Swap operations
Transformation operations
Generation operations
Removing operations
Order-changing operations
(until C++17) (C++11)
(C++20) (C++20)
Sampling operations
(C++17)

Sorting and related operations
Partitioning operations
Sorting operations
Binary search operations
(on partitioned ranges)
Set operations (on sorted ranges)
Merge operations (on sorted ranges)
Heap operations
(C++11)
is_heap_until
(C++11)
Minimum/maximum operations
Lexicographical comparison operations
Permutation operations
C library
Numeric operations
Operations on uninitialized memory
定义于头文件 <algorithm>
template < class RandomIt >
RandomIt is_heap_until ( RandomIt first, RandomIt last ) ;
(1) (C++11 起)
(C++20 起为 constexpr)
template < class ExecutionPolicy, class RandomIt >

RandomIt is_heap_until ( ExecutionPolicy && policy,

RandomIt first, RandomIt last ) ;
(2) (C++17 起)
template < class RandomIt, class Compare >
RandomIt is_heap_until ( RandomIt first, RandomIt last, Compare comp ) ;
(3) (C++11 起)
(C++20 起为 constexpr)
template < class ExecutionPolicy, class RandomIt, class Compare >

RandomIt is_heap_until ( ExecutionPolicy && policy,

RandomIt first, RandomIt last, Compare comp ) ;
(4) (C++17 起)

检查范围 [ first , last ) 并找出始于 first 的最大子范围,该范围构成一个

1) 要检查的堆属性是相对于 operator < (C++20 前) std:: less { } (C++20 起) 而言的。
3) 要检查的堆属性是相对于 comp 而言的。
2,4) (1,3) 相同,但根据 policy 执行。
这些重载仅在满足以下所有条件时参与重载决议:

std:: is_execution_policy_v < std:: decay_t < ExecutionPolicy >> true

(C++20 前)

std:: is_execution_policy_v < std:: remove_cvref_t < ExecutionPolicy >> true

(C++20 起)

目录

参数

first, last - 定义待检验元素范围的迭代器对
policy - 要使用的执行策略
comp - 比较函数对象(即满足比较要求对象),当第一个参数小于第二个参数时返回 true

比较函数的签名应等价于:

bool cmp ( const Type1 & a, const Type2 & b ) ;

虽然签名不需要包含 const & ,但函数不得修改传递给它的对象,且必须能够接受所有(可能为 const 的) Type1 Type2 类型的值,无论值类别如何(因此不允许使用 Type1 & ,也不允许使用 Type1 ,除非对于 Type1 移动操作等同于复制操作 (C++11 起) )。
类型 Type1 Type2 必须满足: RandomIt 类型的对象在解引用后能隐式转换到这两个类型。

类型要求
-
RandomIt 必须满足 LegacyRandomAccessIterator 的要求。
-
Compare 必须满足 Compare 的要求。

返回值

最后一个迭代器 it ,其对应的范围 [ first , it ) 构成一个堆。

复杂度

给定 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

示例

#include <algorithm>
#include <iostream>
#include <vector>
int main()
{
    std::vector<int> v{3, 1, 4, 1, 5, 9};
    std::make_heap(v.begin(), v.end());
    // 可能会破坏堆结构
    v.push_back(2);
    v.push_back(6);
    auto heap_end = std::is_heap_until(v.begin(), v.end());
    std::cout << "all of v:  ";
    for (const auto& i : v)
        std::cout << i << ' ';
    std::cout << '\n';
    std::cout << "only heap: ";
    for (auto i = v.begin(); i != heap_end; ++i)
        std::cout << *i << ' ';
    std::cout << '\n';
}

输出:

all of v:  9 5 4 1 1 3 2 6
only heap: 9 5 4 1 1 3 2

参见

(C++11)
检查给定范围是否构成最大堆
(函数模板)
从元素范围创建最大堆
(函数模板)
向最大堆添加元素
(函数模板)
从最大堆中移除最大元素
(函数模板)
将最大堆转换为按升序排序的元素范围
(函数模板)
查找构成最大堆的最大子范围
(算法函数对象)