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++ 标准。

参见