std::stable_partition
| Определён в заголовке <algorithm>
|
||
template< class BidirIt, class UnaryPred >
BidirIt stable_partition( BidirIt first, BidirIt last, UnaryPred p );
|
(1) | (constexpr начиная с C++26) |
template< class ExecutionPolicy, class BidirIt, class UnaryPred >
BidirIt stable_partition( ExecutionPolicy&& policy,
BidirIt first, BidirIt last, UnaryPred p );
|
(2) | (начиная с C++17) |
[first, last) таким образом, что все элементы, для которых предикат p возвращает true, предшествуют элементам, для которых предикат p возвращает false. Относительный порядок элементов сохраняется.policy.true:
|
|
(до C++20) |
|
|
(начиная с C++20) |
Если выполняется любое из следующих условий, поведение не определено:
|
(до C++11) |
|
(начиная с C++11) |
Параметры
| first, last | - | пара итераторов, определяющих диапазон элементов для переупорядочивания |
| policy | - | политика выполнения для использования |
| p | - |
унарный предикат, который возвращает
true
если элемент должен быть упорядочен перед другими элементами.
Выражение
p
(
v
)
должно быть преобразуемо в
bool
для каждого аргумента
|
| Требования к типам | ||
-
BidirIt
должен удовлетворять требованиям
LegacyBidirectionalIterator
.
|
||
-
UnaryPred
должен удовлетворять требованиям
Predicate
.
|
||
Возвращаемое значение
Итератор на первый элемент второй группы.
Сложность
Дано N как std:: distance ( first, last ) :
Исключения
Перегрузка с параметром шаблона с именем
ExecutionPolicy
сообщает об ошибках следующим образом:
-
Если выполнение функции, вызванной как часть алгоритма, выбрасывает исключение и
ExecutionPolicyявляется одним из стандартных политик , std::terminate вызывается. Для любой другойExecutionPolicyповедение определяется реализацией. - Если алгоритму не удается выделить память, std::bad_alloc выбрасывается.
Примечания
Эта функция пытается выделить временный буфер. Если выделение завершается неудачей, выбирается менее эффективный алгоритм.
Реализации в libc++ и libstdc++ также принимают диапазоны, обозначенные LegacyForwardIterator s в качестве расширения.
| Макрос тестирования возможностей | Значение | Стандарт | Функция |
|---|---|---|---|
__cpp_lib_constexpr_algorithms
|
202306L
|
(C++26) | constexpr стабильная сортировка ( 1 ) |
Пример
#include <algorithm> #include <iostream> #include <vector> int main() { std::vector<int> v{0, 0, 3, -1, 2, 4, 5, 0, 7}; std::stable_partition(v.begin(), v.end(), [](int n) { return n > 0; }); for (int n : v) std::cout << n << ' '; std::cout << '\n'; }
Вывод:
3 2 4 5 7 0 0 -1 0
Отчеты о дефектах
Следующие отчеты об изменениях поведения, влияющие на дефекты, были применены ретроактивно к ранее опубликованным стандартам C++.
| DR | Applied to | Behavior as published | Correct behavior |
|---|---|---|---|
| LWG 2150 | C++98 |
std::stable_partition
требовалось только разместить один
элемент, удовлетворяющий p перед одним элементом, не удовлетворяющим p |
исправлено
требование |
Смотри также
| делит диапазон элементов на две группы (шаблон функции & функциональный объект алгоритма) | |
(C++20) |
|
(C++20) |
делит элементы на две группы, сохраняя их относительный порядок в каждой группе (функциональный объект алгоритма) |