std:: partial_sort_copy

Сортирует некоторые элементы в диапазоне [ first , last ) в порядке возрастания, сохраняя результат в диапазоне [ d_first , d_last ) .

Не более d_last - d_first элементов отсортировано и размещено в диапазоне [ d_first , d_first + n ) . n — количество элементов для сортировки ( std:: min ( std:: distance ( first, last ) , d_last - d_first ) ). Порядок равных элементов не гарантируется.

Если * first не является записываемым в d_first , программа является некорректной.

Если выполняется любое из следующих условий, поведение является неопределённым:

Параметры

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

Итератор на элемент, определяющий верхнюю границу отсортированного диапазона, т.е. d_first + std:: min ( std:: distance ( first, last ) , d_last - d_first ) .

Сложность

Пусть \(\scriptsize N\) N равно std:: distance ( first, last ) , \(\scriptsize D\) D равно d_last - d_first :

Исключения

Перегрузки с параметром шаблона с именем ExecutionPolicy сообщают об ошибках следующим образом:

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

Возможная реализация

Смотрите также реализации в libstdc++ и libc++ .

Пример

#include <algorithm>
#include <functional>
#include <iostream>
#include <string_view>
#include <type_traits>
#include <vector>
void println(std::string_view rem, const auto& v)
{
    std::cout << rem;
    if constexpr (std::is_scalar_v<std::decay_t<decltype(v)>>)
        std::cout << v;
    else
        for (int e : v)
            std::cout << e << ' ';
    std::cout << '\n';
}
int main()
{
    const auto v0 = {4, 2, 5, 1, 3};
    std::vector<int> v1{10, 11, 12};
    std::vector<int> v2{10, 11, 12, 13, 14, 15, 16};
    std::vector<int>::iterator it;
    it = std::partial_sort_copy(v0.begin(), v0.end(), v1.begin(), v1.end());
    println("Writing to the smaller vector in ascending order gives: ", v1);
    if (it == v1.end())
        println("The return value is the end iterator", ' ');
    it = std::partial_sort_copy(v0.begin(), v0.end(), v2.begin(), v2.end(),
                                std::greater<int>());
    println("Writing to the larger vector in descending order gives: ", v2);
    println("The return value is the iterator to ", *it);
}

Writing to the smaller vector in ascending order gives: 1 2 3
The return value is the end iterator
Writing to the larger vector in descending order gives: 5 4 3 2 1 15 16
The return value is the iterator to 15

Отчёты о дефектах

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

Смотрите также