std::pop_heap
| 定义于头文件 <algorithm>
|
||
template< class RandomIt >
void pop_heap( RandomIt first, RandomIt last );
|
(1) | (C++20 起 constexpr) |
template< class RandomIt, class Compare >
void pop_heap( RandomIt first, RandomIt last, Compare comp );
|
(2) | (C++20 起 constexpr) |
交换位于位置 first 的值与位置 last - 1 的值,并使子范围 [first, last - 1) 成为堆。这具有从堆 [first, last)中移除首元素的效果。
[first, last) 是一个关于 operator<(C++20 前)std::less{}(C++20 起) 的堆。[first, last) 是一个关于 comp 的堆。若满足以下任何条件,则行为未定义:
[first,last)为空。[first,last)不是关于相应比较器的堆。
|
(C++11 前) |
|
(C++11 起) |
参数
| first, last | - | 定义待修改(提取根节点)的非空二叉堆元素范围的迭代器对 |
| comp | - |
比较函数对象(即满足比较要求
Compare
的对象),当第一个参数
小于
第二个时返回
true
。
比较函数的签名应等价于如下形式: bool cmp ( const Type1 & a, const Type2 & b ) ;
虽然签名不需要包含
const
&
,但函数不得修改传递的对象,且必须能接受所有(可能为 const 的)
|
| 类型要求 | ||
-
RandomIt
必须满足
随机访问迭代器
的要求。
|
||
-
Compare
必须满足
比较
的要求。
|
||
复杂度
给定 N 为 std:: distance ( first, last ) :
示例
#include <algorithm> #include <iostream> #include <string_view> #include <type_traits> #include <vector> void println(std::string_view rem, const auto& v) { std::cout << rem; if constexpr (std::is_scalar_v<std::decay_t<decltype(v)>>) std::cout << v; else for (int e : v) std::cout << e << ' '; std::cout << '\n'; } int main() { std::vector<int> v{3, 1, 4, 1, 5, 9}; std::make_heap(v.begin(), v.end()); println("after make_heap: ", v); std::pop_heap(v.begin(), v.end()); // 将最大元素移至末尾 println("after pop_heap: ", v); int largest = v.back(); println("largest element: ", largest); v.pop_back(); // 实际移除最大元素 println("after pop_back: ", v); }
输出:
after make_heap: 9 5 4 1 1 3 after pop_heap: 5 3 4 1 1 9 largest element: 9 after pop_back: 5 3 4 1 1
缺陷报告
以下行为变更缺陷报告被追溯应用于先前发布的C++标准。
| 缺陷报告 | 应用于 | 发布时的行为 | 正确行为 |
|---|---|---|---|
| LWG 1205 | C++98 |
当
[
first
,
last
)
为空时行为不明确
|
此情况下行为未定义 |
另见
| 向最大堆添加元素 (函数模板 & 算法函数对象) | |
(C++20) |
|
(C++11) |
检查给定范围是否为最大堆 (函数模板 & 算法函数对象) |
(C++20) |
|
(C++11) |
找到是最大堆的最大子范围 (函数模板 & 算法函数对象) |
(C++20) |
|
| 从元素范围创建最大堆 (函数模板 & 算法函数对象) | |
(C++20) |
|
| 将最大堆转换为按升序排序的元素范围 (函数模板 & 算法函数对象) | |
(C++20) |
|
(C++20) |
从最大堆移除最大元素 (算法函数对象) |