std:: exclusive_scan
|
헤더 파일에 정의됨
<numeric>
|
||
|
template
<
class
InputIt,
class
OutputIt,
class
T
>
OutputIt exclusive_scan
(
InputIt first, InputIt last,
|
(1) |
(C++17부터)
(C++20부터 constexpr) |
|
template
<
class
ExecutionPolicy,
class
ForwardIt1,
class
ForwardIt2,
class
T
>
|
(2) | (C++17부터) |
|
template
<
class
InputIt,
class
OutputIt,
class
T,
class
BinaryOp
>
|
(3) |
(C++17부터)
(C++20부터 constexpr) |
|
template
<
class
ExecutionPolicy,
class
ForwardIt1,
class
ForwardIt2,
|
(4) | (C++17부터) |
[
0
,
std::
distance
(
first, last
)
)
범위 내에서, 다음 연산들을 순서대로 수행합니다:
-
init
뒤에
[first,iter)범위의 요소들을 순서대로 연결하여 새로운 시퀀스를 생성합니다. 여기서 iter 는 first 의 다음 i 번째 반복자입니다. - op 를 사용하여 시퀀스의 일반화된 비가환 합을 계산합니다.
- 결과를 * dest 에 할당합니다. 여기서 dest 는 d_first 의 다음 i 번째 반복자입니다.
|
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 이후) |
시퀀스의 원소들에 대한 이진 연산 binary_op 에 대한 일반화된 비가환 합 은 다음과 같이 정의됩니다:
- 시퀀스에 요소가 하나만 있는 경우, 합계는 해당 요소의 값입니다.
- 그렇지 않으면 다음 작업을 순서대로 수행합니다:
- 시퀀스에서 인접한 두 요소 elem1 와 elem2 를 선택합니다.
- binary_op ( elem1, elem2 ) 를 계산하고 시퀀스 내 두 요소를 결과값으로 대체합니다.
- 시퀀스에 요소가 하나만 남을 때까지 1단계와 2단계를 반복합니다.
주어진
binary_op
를 실제 이항 연산으로 사용:
- 결과는 binary_op 이 결합 법칙을 만족하지 않는 경우(예: 부동 소수점 덧셈) 비결정적입니다.
-
다음 값 중 어느 하나라도
T로 변환할 수 없는 경우 프로그램의 형식이 올바르지 않습니다:
-
- binary_op ( init, * first )
- binary_op ( init, init )
- binary_op ( * first, * first )
- 다음 조건 중 하나라도 충족되면, 동작은 정의되지 않습니다:
-
-
T가 MoveConstructible 가 아닙니다. -
binary_op
이
[first,last)범위의 어떤 요소를 수정합니다. -
binary_op
이
[first,last]범위의 어떤 반복자나 하위 범위를 무효화합니다.
-
목차 |
매개변수
| first, last | - | 합계를 구할 요소들의 범위 를 정의하는 반복자 쌍 |
| d_first | - | 대상 범위의 시작점; first 와 같을 수 있음 |
| policy | - | 사용할 실행 정책 |
| init | - | 초기값 |
| op | - | 입력 반복자를 역참조한 결과, 다른 op 의 결과, 그리고 init 에 적용될 이항 FunctionObject |
| 타입 요구사항 | ||
-
InputIt
는
LegacyInputIterator
요구사항을 충족해야 함
|
||
-
OutputIt
는
LegacyOutputIterator
요구사항을 충족해야 함
|
||
-
ForwardIt1, ForwardIt2
는
LegacyForwardIterator
요구사항을 충족해야 함
|
||
반환값
쓰여진 마지막 요소 다음의 요소를 가리키는 반복자.
복잡도
주어진 N 이 std:: distance ( first, last ) 인 경우:
예외
ExecutionPolicy
라는 템플릿 매개변수를 사용하는 오버로드는 다음과 같이 오류를 보고합니다:
-
알고리즘의 일부로 호출된 함수 실행 중 예외가 발생하고
ExecutionPolicy가 표준 정책 중 하나인 경우, std::terminate 가 호출됩니다. 다른ExecutionPolicy의 경우 동작은 구현에 따라 정의됩니다. - 알고리즘이 메모리 할당에 실패할 경우, std::bad_alloc 이 throw됩니다.
예제
#include <functional> #include <iostream> #include <iterator> #include <numeric> #include <vector> int main() { std::vector data{3, 1, 4, 1, 5, 9, 2, 6}; std::cout << "Exclusive sum: "; std::exclusive_scan(data.begin(), data.end(), std::ostream_iterator<int>(std::cout, " "), 0); std::cout << "\nInclusive sum: "; std::inclusive_scan(data.begin(), data.end(), std::ostream_iterator<int>(std::cout, " ")); std::cout << "\n\nExclusive product: "; std::exclusive_scan(data.begin(), data.end(), std::ostream_iterator<int>(std::cout, " "), 1, std::multiplies<>{}); std::cout << "\nInclusive product: "; std::inclusive_scan(data.begin(), data.end(), std::ostream_iterator<int>(std::cout, " "), std::multiplies<>{}); }
출력:
Exclusive sum: 0 3 4 8 9 14 23 25 Inclusive sum: 3 4 8 9 14 23 25 31 Exclusive product: 1 3 3 12 12 60 540 1080 Inclusive product: 3 3 12 12 60 540 1080 6480
참고 항목
|
범위 내 인접한 요소들 간의 차이를 계산합니다
(함수 템플릿) |
|
|
요소들의 범위를 합산하거나 접습니다
(함수 템플릿) |
|
|
요소 범위의 부분 합을 계산합니다
(함수 템플릿) |
|
|
(C++17)
|
호출 가능 객체를 적용한 후 배타적 스캔을 계산합니다
(함수 템플릿) |
|
(C++17)
|
std::partial_sum
과 유사하며,
i
th
번째 입력 요소를
i
th
번째 합에 포함합니다
(함수 템플릿) |