push_heap.md

push_heap

• algorithm[meta header]
• std[meta namespace]
• function template[meta id-type]

namespace std {
  template <class RandomAccessIterator>
  void push_heap(RandomAccessIterator first, RandomAccessIterator last);

  template <class RandomAccessIterator, class Compare>
  void push_heap(RandomAccessIterator first, RandomAccessIterator last,
                 Compare comp);
}

概要

ヒープ化された範囲に要素を追加したヒープ範囲を得る

要件

• [first,last - 1) は有効な heap である必要がある。
• *first の型は MoveConstructible と MoveAssignable の要件を満たしている必要がある。

効果

last - 1 の値を、[first,last) が有効な heap となるように配置する

戻り値

なし

計算量

最大で log(last - first) 回比較する。

例

#include <iostream>
#include <vector>
#include <algorithm>

int main()
{
  std::vector<int> v = {3, 1, 4};

  std::make_heap(v.begin(), v.end());

  // 要素を追加してヒープ化
  v.push_back(2);
  std::push_heap(v.begin(), v.end());

  std::sort_heap(v.begin(), v.end());

  std::for_each(v.begin(), v.end(), [](int x) {
    std::cout << x << std::endl;
  });
}

• std::push_heap[color ff0000]
• std::make_heap[link make_heap.md]
• v.push_back[link /reference/vector/vector/push_back.md]
• std::sort_heap[link sort_heap.md]

出力

1
2
3
4

実装例

template <class RandomAccessIterator>
void push_heap(RandomAccessIterator first, RandomAccessIterator last)
{
  using difference_type = typename std::iterator_traits<RandomAccessIterator>::difference_type;
  using value_type      = typename std::iterator_traits<RandomAccessIterator>::value_type;
  difference_type c = last - first - 1;
  value_type v = std::move(first[c]);
  while (c > 0) {
    difference_type p = (c - 1) / 2;
    if (!bool(first[p] < v))
      break;
    first[c] = std::move(first[p]);
    c = p;
  }
  first[c] = std::move(v);
}

template <class RandomAccessIterator, class Compare>
void push_heap(RandomAccessIterator first, RandomAccessIterator last, Compare comp)
{
  using difference_type = typename std::iterator_traits<RandomAccessIterator>::difference_type;
  using value_type      = typename std::iterator_traits<RandomAccessIterator>::value_type;

  difference_type c = last - first - 1;
  value_type v = std::move(first[c]);
  while (c > 0) {
    difference_type p = (c - 1) / 2;
    if (!bool(comp(first[p], v)))
      break;
    first[c] = std::move(first[p]);
    c = p;
  }
  first[c] = std::move(v);
}

• std::move[link /reference/utility/move.md]
• std::iterator_traits[link /reference/iterator/iterator_traits.md]