Namespaces
Variants

std::inplace_merge

cppreference.net에서
 
 
알고리즘 라이브러리
제약된 알고리즘 및 범위 기반 알고리즘 (C++20)
제약된 알고리즘, 예: ranges::copy, ranges::sort, ...
정렬 및 관련 연산
분할 연산
(C++11)    

정렬 연산
이진 탐색 연산
(분할된 범위에 대해)
집합 연산 (정렬된 범위에 대해)
병합 연산 (정렬된 범위에 대해)
힙 연산
최소/최대 연산
(C++11)
(C++17)
사전식 비교 연산
순열 연산


 
헤더 <algorithm>
template< class BidirIt >
void inplace_merge( BidirIt first, BidirIt middle, BidirIt last );
에 정의됨 (1) (C++26부터 constexpr)
template< class ExecutionPolicy, class BidirIt >
void inplace_merge( ExecutionPolicy&& policy,
                    BidirIt first, BidirIt middle, BidirIt last );
(2) (C++17부터)
template< class BidirIt, class Compare >
void inplace_merge( BidirIt first, BidirIt middle, BidirIt last,
                    Compare comp );
(3) (C++26부터 constexpr)
template< class ExecutionPolicy, class BidirIt, class Compare >
void inplace_merge( ExecutionPolicy&& policy,
                    BidirIt first, BidirIt middle, BidirIt last,
                    Compare comp );
(4) (C++17부터)

두 개의 연속적인 정렬된 범위 [first, middle)와 [middle, last)을 하나의 정렬된 범위 [first, last)로 병합합니다.

1) 만약 [first, middle) 또는 [middle, last)이 정렬되지 않았다면 (operator<(C++20까지)std::less{}(C++20부터)), 동작은 정의되지 않습니다.
3) 만약 [first, middle) 또는 [middle, last)이 comp에 대해 정렬되지 않았다면, 동작은 정의되지 않습니다.
2,4) (1,3)과 동일하지만, 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이 Swappable이 아닙니다.
(C++11까지)
(C++11부터)

매개변수

first - 첫 번째 정렬된 범위의 시작
middle - 첫 번째 정렬된 범위의 끝이자 두 번째 범위의 시작
last - 두 번째 정렬된 범위의 끝
policy - 사용할 실행 정책
comp - 비교 함수 객체 (즉, Compare의 요구 사항을 만족하는 객체)로, ​true을 반환합니다 (첫 번째 인수가 두 번째 인수보다 작거나 (즉, 앞서)는 경우).

비교 함수의 시그니처는 다음과 같아야 합니다:

bool cmp(const Type1& a, const Type2& b);

시그니처에 const&이 있을 필요는 없지만, 함수는 전달된 객체를 수정해서는 안 되며, 유형 (const일 수 있음) Type1와 Type2의 모든 값을 값 카테고리에 관계없이 수용할 수 있어야 합니다 (따라서 Type1&는 허용되지 않으며, Type1은 이동이 복사와 동등한 경우가 아니면 허용되지 않습니다Type1(C++11부터)).
유형 Type1과 Type2은 BidirIt 유형의 객체를 역참조한 후 암시적으로 두 유형 모두로 변환될 수 있어야 합니다. ​

유형 요구 사항
-
BidirIt는 LegacyBidirectionalIterator의 요구 사항을 충족해야 합니다.
-
Compare는 Compare의 요구 사항을 충족해야 합니다.

복잡도

주어진 N이 std::distance(first, last)일 때:

1) 충분한 추가 메모리가 있는 경우 정확히 N-1번의 operator<(C++20까지)std::less{}(C++20부터) 비교, 그렇지 않은 경우 O(N⋅log(N)) 비교를 수행합니다.
2) O(N⋅log(N))번의 operator<(C++20까지)std::less{}(C++20부터) 비교를 수행합니다.
3) 충분한 추가 메모리가 있는 경우 정확히 N-1번의 비교 함수 comp 적용, 그렇지 않은 경우 O(N⋅log(N))번의 적용을 수행합니다.
4) O(N⋅log(N))번의 비교 함수 comp 적용을 수행합니다.

예외

템플릿 매개변수 이름이 ExecutionPolicy인 오버로드는 다음과 같이 오류를 보고합니다:

  • 알고리즘의 일부로 호출된 함수의 실행이 예외를 발생시키고 ExecutionPolicy가 표준 정책 중 하나인 경우, std::terminate가 호출됩니다. 다른 ExecutionPolicy의 경우 동작은 구현 정의입니다.
  • 알고리즘이 메모리 할당에 실패하면 std::bad_alloc이 발생합니다.

가능한 구현

libstdc++ 및 libc++의 구현을 참조하십시오.

참고

이 함수는 임시 버퍼를 할당하려고 시도합니다. 할당에 실패하면 덜 효율적인 알고리즘이 선택됩니다.

기능 테스트 매크로 값 표준 기능
__cpp_lib_constexpr_algorithms 202306L (C++26) constexpr 제자리 병합 (1), (3)

예제

다음 코드는 병합 정렬의 구현입니다.

#include <algorithm>
#include <iostream>
#include <vector>

template<class Iter>
void merge_sort(Iter first, Iter last)
{
    if (last - first > 1)
    {
        Iter middle = first + (last - first) / 2;
        merge_sort(first, middle);
        merge_sort(middle, last);
        std::inplace_merge(first, middle, last);
    }
}

int main()
{
    std::vector<int> v{8, 2, -2, 0, 11, 11, 1, 7, 3};
    merge_sort(v.begin(), v.end());
    for (const auto& n : v)
        std::cout << n << ' ';
    std::cout << '\n';
}

출력:

-2 0 1 2 3 7 8 11 11

같이 보기

두 개의 정렬된 범위를 병합합니다
(함수 템플릿 & 알고리즘 함수 객체)
요소 범위를 정렬합니다
(함수 템플릿 & 알고리즘 함수 객체)
동등한 요소 간의 상대적 순서를 유지하면서 요소 범위를 정렬합니다
(함수 템플릿 & 알고리즘 함수 객체)
두 개의 정렬된 범위를 제자리에서 병합합니다
(알고리즘 함수 객체)