Namespaces
Variants

std:: partition_copy

From cppreference.net
Algorithm library
Constrained algorithms and algorithms on ranges (C++20)
Constrained algorithms, e.g. ranges::copy , ranges::sort , ...
Execution policies (C++17)
Non-modifying sequence operations
Batch operations
(C++17)
Search operations
Modifying sequence operations
Copy operations
(C++11)
(C++11)
Swap operations
Transformation operations
Generation operations
Removing operations
Order-changing operations
(until C++17) (C++11)
(C++20) (C++20)
Sampling operations
(C++17)

Sorting and related operations
Partitioning operations
partition_copy
(C++11)
Sorting operations
Binary search operations
(on partitioned ranges)
Set operations (on sorted ranges)
Merge operations (on sorted ranges)
Heap operations
Minimum/maximum operations
Lexicographical comparison operations
Permutation operations
C library
Numeric operations
Operations on uninitialized memory
定义于头文件 <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 执行。
此重载仅在满足以下所有条件时参与重载决议:

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

(C++20 前)

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

(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. 此情况下的行为
是未定义的

参见

将元素范围划分为两组
(函数模板)
划分元素为两组并保持其相对顺序
(函数模板)
复制元素范围到新位置
(函数模板)
复制元素范围并跳过满足特定条件的元素
(函数模板)
复制范围并将元素划分为两组
(算法函数对象)