std::push_heap — cppreference.com

Материал из cppreference.com

Определено в заголовочном файле `<algorithm>`
`template< class RandomIt > void push_heap( RandomIt first, RandomIt last );`	(1)
`template< class RandomIt, class Compare > void push_heap( RandomIt first, RandomIt last, Compare comp );`	(2)

Вставляет элемент в положении last-1 в кучу определяется диапазон [first, last-1). Первая версия функции используется operator< для сравнения элементов, второй использует данную функцию сравнения comp.

Оригинал:

Inserts the element at the position last-1 into the heap defined by the range [first, last-1). The first version of the function uses operator< to compare the elements, the second uses the given comparison function comp.

Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

Параметры

first, last	—	диапазон элементов, определяющих кучу изменить Оригинал: the range of elements defining the heap to modify Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
comp	—	объект функции сравнения (т.е. объект, удовлетворяющий требованиям Compare), который возвращает `true`, если первый аргумент "меньше", чем второй. Определение сравнения должно быть эквивалентно: `bool cmp(const Type1 &a, const Type2 &b);` Использование `noexcept` (начиная с C++11) желательно но не обязательно. Параметры не обязаны передаваться по `const&`, но не должны модифицироваться. Они должны быть способны принимать все значения типа (даже `const`) `Type1` и `Type2` независимо от категории значений (таким образом, `Type1&` не допускается, равно как и `Type1`, если только для `Type1` перемещение не эквивалентно копированию (начиная с C++11)). Типы `Type1` и `Type2` должны быть таковы, что объект типа `RandomIt` может быть разыменован и затем неявно преобразован в оба из них.
Требования к типам
-`RandomIt` должен соответствовать требованиям `RandomAccessIterator`.
-The type of dereferenced `RandomIt` must meet the requirements of `MoveAssignable` and `MoveConstructible`.

Возвращаемое значение

(Нет)

Сложность

Не более 2 × log(N) сравнений, где N=std::distance(first, last).

Оригинал:

At most 2×log(N) comparisons where N=std::distance(first, last).

Заметки

' Кучу целый ряд элементов [f,l), который имеет следующие свойства:

Оригинал:

A heap is a range of elements [f,l) that has the following properties:

*f является крупнейшим элементом в ассортименте
Оригинал:
*f is the largest element in the range
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
Новый элемент может быть добавлена с помощью std::push_heap()
Оригинал:
a new element can be added using std::push_heap()
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
Первый элемент можно удалить с помощью std::pop_heap()
Оригинал:
the first element can be removed using std::pop_heap()
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

Фактическое расположение элементов, определяется реализацией.

Оригинал:

The actual arrangement of the elements is implementation defined.

Пример

#include <iostream>
#include <algorithm>

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

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

    std::cout << "v: ";
    for (auto i : v) std::cout << i << ' ';
    std::cout << '\n';

    v.push_back(6);

    std::cout << "before push_heap: ";
    for (auto i : v) std::cout << i << ' ';
    std::cout << '\n';

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

    std::cout << "after push_heap: ";
    for (auto i : v) std::cout << i << ' ';
    std::cout << '\n';
}

Вывод:

v: 9 5 4 1 1 3
before push_heap: 9 5 4 1 1 3 6
after push_heap:  9 5 6 1 1 3 4

См. также

Категории: