std::nth_element

template< class RandomIt >
void nth_element( RandomIt first, RandomIt nth, RandomIt last );

template< class ExecutionPolicy, class RandomIt >
void nth_element( ExecutionPolicy&& policy,
                  RandomIt first, RandomIt nth, RandomIt last );

template< class RandomIt, class Compare >
void nth_element( RandomIt first, RandomIt nth, RandomIt last,
                  Compare comp );

template< class ExecutionPolicy, class RandomIt, class Compare >
void nth_element( ExecutionPolicy&& policy,
                  RandomIt first, RandomIt nth, RandomIt last,
                  Compare comp );

nth_element таким образом, что после перестановки: [first, last)Элемент, на который указывает

• заменяется на тот элемент, который оказался бы на этой позиции, если бы nth был отсортирован.[first, last)Для каждого итератора
• в i и каждого итератора [first, nth) в j выполняется следующее условие:[nth, last)1,2)

или

• [first, nth) не является [nth, last)допустимым диапазоном.Тип

first, last

Принимая

\( \scriptsize N\)N как : last - first1)

Перегрузки с параметром шаблона с именем

сообщают об ошибках следующим образом: ExecutionPolicyЕсли выполнение функции, вызванной в рамках алгоритма, генерирует исключение, и

• является одной из ExecutionPolicyстандартных политик, вызывается std::terminate. Для любого другого поведение определяется реализацией.ExecutionPolicyЕсли алгоритму не удаётся выделить память,
• std::bad_alloc генерируется.Возможная реализация

Также см. реализации в

libstdc++, libc++, и MSVC STL. Примечания

Обычно используется алгоритм

Интроселекция, хотя допускаются и другие алгоритмы выбора с подходящей средней сложностью. Пример

Запустить этот код

#include <algorithm>
#include <cassert>
#include <functional>
#include <iostream>
#include <numeric>
#include <vector>

void printVec(const std::vector<int>& vec)
{
    std::cout << "v = {";
    for (char sep[]{0, ' ', 0}; const int i : vec)
        std::cout << sep << i, sep[0] = ',';
    std::cout << "};\n";
}

int main()
{
    std::vector<int> v{5, 10, 6, 4, 3, 2, 6, 7, 9, 3};
    printVec(v);
    
    auto m = v.begin() + v.size() / 2;
    std::nth_element(v.begin(), m, v.end());
    std::cout << "\nThe median is " << v[v.size() / 2] << '\n';
    // The consequence of the inequality of elements before/after the Nth one:
    assert(std::accumulate(v.begin(), m, 0) < std::accumulate(m, v.end(), 0));
    printVec(v);
    
    // Note: comp function changed
    std::nth_element(v.begin(), v.begin() + 1, v.end(), std::greater{});
    std::cout << "\nThe second largest element is " << v[1] << '\n';
    std::cout << "The largest element is " << v[0] << '\n';
    printVec(v);
}

v = {5, 10, 6, 4, 3, 2, 6, 7, 9, 3};

The median is 6
v = {3, 2, 3, 4, 5, 6, 10, 7, 9, 6};

The second largest element is 9
The largest element is 10
v = {10, 9, 6, 7, 6, 3, 5, 4, 3, 2};

Следующие отчёты о дефектах, изменяющие поведение, были применены ретроактивно к ранее опубликованным стандартам C++.

DR

max_element