std:: reverse
|
헤더 파일에 정의됨
<algorithm>
|
||
|
template
<
class
BidirIt
>
void reverse ( BidirIt first, BidirIt last ) ; |
(1) | (C++20부터 constexpr) |
|
template
<
class
ExecutionPolicy,
class
BidirIt
>
void reverse ( ExecutionPolicy && policy, BidirIt first, BidirIt last ) ; |
(2) | (C++17부터) |
[
first
,
last
)
.
[
0
,
std::
distance
(
first, last
)
/
2
)
범위 내에서 각 반복자 쌍
first
+
i
와
(
last
-
i
)
-
1
에
std::iter_swap
을 적용하는 것처럼 동작합니다.
|
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
가
Swappable
가 아닌 경우
(C++20 이전)
BidirIt
이
ValueSwappable
가 아닌 경우
(C++20 이후)
, 동작은 정의되지 않습니다.
목차 |
매개변수
| first, last | - | 역순으로 만들 요소들의 범위 를 정의하는 반복자 쌍 |
| policy | - | 사용할 실행 정책 |
| 타입 요구사항 | ||
-
BidirIt
는
LegacyBidirectionalIterator
의 요구사항을 충족해야 함
|
||
복잡도
정확히 std:: distance ( first, last ) / 2 번의 교환.
예외
ExecutionPolicy
라는 템플릿 매개변수를 사용하는 오버로드는 다음과 같이 오류를 보고합니다:
-
알고리즘의 일부로 호출된 함수 실행 중 예외가 발생하고
ExecutionPolicy가 표준 정책 중 하나인 경우, std::terminate 가 호출됩니다. 다른ExecutionPolicy의 경우 동작은 구현에 따라 정의됩니다. - 알고리즘이 메모리 할당에 실패할 경우, std::bad_alloc 이 throw됩니다.
가능한 구현
다음 구현들도 참조하십시오: libstdc++ , libc++ , 그리고 MSVC STL .
template<class BidirIt> constexpr // since C++20 void reverse(BidirIt first, BidirIt last) { using iter_cat = typename std::iterator_traits<BidirIt>::iterator_category; // 태그 디스패치, 예: reverse_impl(first, last, iter_cat()) 호출은 // C++14 및 이전 모드에서 사용할 수 있습니다. if constexpr (std::is_base_of_v<std::random_access_iterator_tag, iter_cat>) { if (first == last) return; for (--last; first < last; (void)++first, --last) std::iter_swap(first, last); } else while (first != last && first != --last) std::iter_swap(first++, last); } |
참고 사항
구현체들(예:
MSVC STL
)은 반복자 타입이
LegacyContiguousIterator
요구사항을 충족하고 해당 값 타입의 교환(swapping)이 비트리비얼(non-trivial) 특수 멤버 함수나
ADL
을 통해 발견된
swap
을 호출하지 않을 때 벡터화(vectorization)를 활성화할 수 있습니다.
예제
#include <algorithm> #include <iostream> #include <iterator> #include <vector> void println(auto rem, auto const& v) { for (std::cout << rem; auto e : v) std::cout << e << ' '; std::cout << '\n'; } int main() { std::vector<int> v {1, 2, 3}; std::reverse(v.begin(), v.end()); println("after reverse, v = ", v); int a[] = {4, 5, 6, 7}; std::reverse(std::begin(a), std::end(a)); println("after reverse, a = ", a); }
출력:
after reverse, v = 3 2 1 after reverse, a = 7 6 5 4
결함 보고서
다음의 동작 변경 결함 보고서들은 이전에 발표된 C++ 표준에 소급 적용되었습니다.
| DR | 적용 대상 | 게시된 동작 | 올바른 동작 |
|---|---|---|---|
| LWG 223 | C++98 | std::swap 이 각 반복자 쌍에 적용됨 | 대신 std::iter_swap 을 적용함 |
| LWG 2039 | C++98 |
std::iter_swap
이
i
가 std:: distance ( first, last ) / 2 와 같을 때도 적용됨 |
적용되지 않음 |
참고 항목
|
역순으로 정렬된 범위의 복사본을 생성합니다
(함수 템플릿) |
|
|
(C++20)
|
범위 내 요소들의 순서를 역순으로 변경합니다
(알고리즘 함수 객체) |