Namespaces
Variants

    std::push_heap

    来自 zh.cppreference.net
     
    C++
     
    算法库
    受约束算法和范围算法 (C++20)
    受约束算法，例如ranges::copy、ranges::sort、...
    排序及相关操作
    划分操作
    (C++11)    
    (C++11)

    排序操作
    二分搜索操作
    (在划分范围上)
    集合操作（在有序范围上）
    合并操作（在有序范围上）
    堆操作
    最小/最大操作
    (C++11)
    (C++17)
    字典序比较操作
    (C++20)
    排列操作


     
    定义于头文件 <algorithm> 
    template< class RandomIt >
void push_heap( RandomIt first, RandomIt last );
    		(1) (自C++20起为constexpr) 
    template< class RandomIt, class Compare >
void push_heap( RandomIt first, RandomIt last, Compare comp );
    		(2) (自C++20起为constexpr)

    将位于位置 last - 1 的元素插入到堆 [first, last - 1)中。插入后的堆将是 [first, last)。

    1) 堆是按照 operator<(C++20前)std::less{}(自C++20起) 进行比较的。
    2) 堆是按照 comp 进行比较的。

    如果满足以下任何条件，则行为未定义：

    • [first, last - 1) 不是相对于相应比较器的堆。
    (C++11前)
    (自C++11起)

    参数

    first, last - 定义构成插入后二叉堆元素范围的迭代器对
    comp - 比较函数对象（即满足 比较 要求的对象），当第一个参数 小于 第二个时返回 true 。

    比较函数的签名应等价于如下形式：

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

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

    类型要求
    -
    RandomIt 必须满足 随机访问迭代器 的要求。
    -
    Compare 必须满足 比较 的要求。

    复杂度

    给定 N 为 std:: distance ( first, last ) ：

    1) 最多进行 log(N) 次比较，使用 operator < (C++20 前) std:: less { } (C++20 起) 。
    2) 最多应用 log(N) 次比较函数 comp 。

    示例

    运行此代码 
    #include <algorithm>
#include <iostream>
#include <string_view>
#include <vector>
void println(std::string_view rem, const std::vector<int>& v)
{
    std::cout << rem;
    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);
    v.push_back(6);
    println("after push_back: ", v);
    std::push_heap(v.begin(), v.end());
    println("after push_heap: ", v);
}

    输出： 

    after make_heap: 9 5 4 1 1 3
after push_back: 9 5 4 1 1 3 6
after push_heap: 9 5 6 1 1 3 4

    缺陷报告

    下列行为变更缺陷报告被追溯应用于先前发布的C++标准。

    缺陷报告 应用于 发布时行为 正确行为
    LWG 3032 C++98 未要求 [ first , last ) 范围内的元素可交换 要求可交换

    参见

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