std::is_heap_until — cppreference.com

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

Определено в заголовочном файле `<algorithm>`
`template< class RandomIt > RandomIt is_heap_until( RandomIt first, RandomIt last );`	(1)	(начиная с C++11)
`template< class RandomIt, class Compare > RandomIt is_heap_until( RandomIt first, RandomIt last, Compare comp );`	(2)	(начиная с C++11)

Рассматривает диапазоне [first, last) и находит самый большой набор начиная с first который' кучи. Первая версия функции используется operator< для сравнения элементов, второй использует данную функцию сравнения comp.

Оригинал:

Examines the range [first, last) and finds the largest range beginning at first which is heap. 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 to examine Текст был переведён автоматически используя Переводчик 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`.

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

Верхняя граница самый большой набор начиная с first который' кучи. То есть, последний it итератора, для которых диапазон [first, it) является' кучи.

Оригинал:

The upper bound of the largest range beginning at first which is heap. That is, the last iterator it for which range [first, it) is heap.

Сложность

Линейный в расстоянии между first и last

Оригинал:

Linear in the distance between first and 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());

    // probably mess up the heap
    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 (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

См. также

проверяет, является ли указанный диапазон максимальной кучей
(шаблон функции) [править]

Категории: