std::stable_partition
| 헤더 <algorithm>
|
||
template< class BidirIt, class UnaryPred >
BidirIt stable_partition( BidirIt first, BidirIt last, UnaryPred p );
|
에 정의됨 (1) | (constexpr since 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
를 반환하는 단항 predicate.
표현식
p
(
v
)
는
|
| 타입 요구사항 | ||
-
BidirIt
는
LegacyBidirectionalIterator
요구사항을 충족해야 합니다.
|
||
-
UnaryPred
는
Predicate
요구사항을 충족해야 합니다.
|
||
반환값
두 번째 그룹의 첫 번째 요소에 대한 반복자.
복잡도
주어진 N 이 std:: distance ( first, last ) 인 경우:
예외
ExecutionPolicy
라는 템플릿 매개변수를 사용하는 오버로드는 다음과 같이 오류를 보고합니다:
-
알고리즘의 일부로 호출된 함수 실행 중 예외가 발생하고
ExecutionPolicy가 표준 정책 중 하나인 경우, std::terminate 가 호출됩니다. 다른ExecutionPolicy의 경우 동작은 구현에 따라 정의됩니다. - 알고리즘이 메모리 할당에 실패하는 경우, std::bad_alloc 이 throw됩니다.
참고 사항
이 함수는 임시 버퍼 할당을 시도합니다. 할당이 실패할 경우, 덜 효율적인 알고리즘이 선택됩니다.
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 | 적용 대상 | 게시된 동작 | 올바른 동작 |
|---|---|---|---|
| LWG 2150 | C++98 |
std::stable_partition
은
p
를 만족하는 하나의 요소를
p 를 만족하지 않는 하나의 요소 앞에 배치하도록만 요구되었음 |
요구 사항을
수정함 |
참고
| 요소의 범위를 두 그룹으로 나눕니다 (함수 템플릿 & 알고리즘 함수 객체) | |
(C++20) |
|
(C++20) |
요소를 두 그룹으로 나누되 각 그룹 내에서 상대적 순서를 유지합니다 (알고리즘 함수 객체) |