Namespaces
Variants

std::partition_copy

来自 zh.cppreference.net
 
 
算法库
受约束算法与范围算法 (C++20)
受约束算法,例如 ranges::copy, ranges::sort, ...
排序及相关操作
划分操作
(C++11)    

排序操作
二分搜索操作
(在划分后的范围上)
集合操作(在已排序范围上)
合并操作(在已排序范围上)
堆操作
最小/最大操作
(C++11)
(C++17)
字典序比较操作
排列操作


 
定义于头文件 <algorithm>
template< class InputIt, class OutputIt1,
          class OutputIt2, class UnaryPred >
std::pair<OutputIt1, OutputIt2>
    partition_copy( InputIt first, InputIt last,
                    OutputIt1 d_first_true, OutputIt2 d_first_false,
                    UnaryPred p );
(1) (自 C++11 起)
(自 C++20 起 constexpr)
template< class ExecutionPolicy, class ForwardIt1, class ForwardIt2,
          class ForwardIt3, class UnaryPred >
std::pair<ForwardIt2, ForwardIt3>
    partition_copy( ExecutionPolicy&& policy,
                    ForwardIt1 first, ForwardIt1 last,
                    ForwardIt2 d_first_true, ForwardIt3 d_first_false,
                    UnaryPred p );
(2) (自 C++17 起)
1) 将范围 [first, last) 复制到两个不同的范围,取决于谓词 p。
  • 满足谓词 p 的元素被复制到以 d_first_true 开头的范围。
  • 剩余的元素被复制到以 d_first_false 开头的范围。
2) 与 (1) 相同,但根据 policy 执行。
此重载仅当以下表达式的值为 true 时才参与重载决议:

std::is_execution_policy_v<std::decay_t<ExecutionPolicy>>

(在 C++20 前)

std::is_execution_policy_v<std::remove_cvref_t<ExecutionPolicy>>

(自 C++20 起)

如果 *first 不是 可写入 到 d_first_true 或 d_first_false,则该程序非良构。

在输入范围和两个输出范围中,如果任意两个范围重叠,则行为未定义。

参数

first, last - 定义待复制元素源 范围 的迭代器对
d_first_true - 满足 p 条件的元素输出范围的起始位置
d_first_false - 不满足 p 条件的元素输出范围的起始位置
policy - 使用的 执行策略
p - 一元谓词,若元素应置于 d_first_true 则返回 ​ true 。

表达式 p ( v ) 必须可转换为 bool ,其中 v 为类型(可能为 const) VT 的参数, VT 是 InputIt 的值类型,且与 值类别 无关,且不得修改 v 。因此不允许参数类型为 VT & ,也不允许为 VT ,除非对于 VT 移动操作等价于复制操作 (C++11 起) 。 ​

类型要求
-
InputIt 必须满足 LegacyInputIterator 的要求。
-
OutputIt1, OutputIt2 必须满足 LegacyOutputIterator 的要求。
-
ForwardIt1, ForwardIt2, ForwardIt3 必须满足 LegacyForwardIterator 的要求。
-
UnaryPred 必须满足 Predicate 的要求。

返回值

一个从指向 d_first_true 范围末尾的迭代器和指向 d_first_false 范围末尾的迭代器构造的 std::pair 。

复杂度

恰好需要 std:: distance ( first, last ) 次对 p 的调用。

对于重载 (2) ,如果 ForwardIt 的值类型不满足 可复制构造 要求,则可能存在性能开销。

异常

带有名为 ExecutionPolicy 模板参数的重载按以下方式报告错误:

  • 如果作为算法一部分调用的函数执行抛出异常,且 ExecutionPolicy 是某个 标准策略 ,则调用 std::terminate 。对于其他任何 ExecutionPolicy ,其行为由实现定义。
  • 如果算法无法分配内存,则抛出 std::bad_alloc 。

可能的实现

partition_copy (1)
template<class InputIt, class OutputIt1,
         class OutputIt2, class UnaryPred>
constexpr //< 自 C++20 起
std::pair<OutputIt1, OutputIt2>
    partition_copy(InputIt first, InputIt last,
                   OutputIt1 d_first_true, OutputIt2 d_first_false,
                   UnaryPred p)
{
    for (; first != last; ++first)
    {
        if (p(*first))
        {
            *d_first_true = *first;
            ++d_first_true;
        }
        else
        {
            *d_first_false = *first;
            ++d_first_false;
        }
    }
    return std::pair<OutputIt1, OutputIt2>(d_first_true, d_first_false);
}

示例

#include <algorithm>
#include <iostream>
#include <utility>
void print(auto rem, const auto& v)
{
    for (std::cout << rem; const auto& x : v)
        std::cout << x << ' ';
    std::cout << '\n';
}
int main()
{
    int arr[10] = {0, 1, 2, 3, 4, 5, 6, 7, 8, 9};
    int true_arr[5] = {0};
    int false_arr[5] = {0};
    std::partition_copy(std::begin(arr), std::end(arr),
                        std::begin(true_arr), std::begin(false_arr),
                        [](int i) { return 4 < i; });
    print("true_arr:  ", true_arr);
    print("false_arr: ", false_arr);
}

输出:

true_arr:  5 6 7 8 9
false_arr: 0 1 2 3 4

缺陷报告

下列行为变更缺陷报告被追溯应用于先前发布的 C++ 标准。

缺陷报告 应用于 发布时的行为 正确行为
P0896R4 C++11
C++17
1. InputIt (C++11)/ ForwardIt1 (C++17) 的值类型
被要求为 CopyAssignable
2. 两个输出范围允许重叠
1. 不再要求
2. 此情况下的行为
是未定义的

另请参阅

将元素范围划分为两组
(函数模板 & 算法函数对象)
将元素划分为两组,同时保留每组内元素的相对顺序
(函数模板 & 算法函数对象)
将元素范围复制到新位置
(函数模板 & 算法函数对象)
复制元素范围并省略满足特定条件的元素
(函数模板 & 算法函数对象)
复制范围并将元素分为两组
(算法函数对象)