std::transform_exclusive_scan
| Определен в заголовке <numeric>
|
||
template< class InputIt, class OutputIt, class T,
class BinaryOp, class UnaryOp >
OutputIt transform_exclusive_scan
( InputIt first, InputIt last, OutputIt d_first, T init,
BinaryOp binary_op, UnaryOp unary_op );
|
(1) | (since C++17) (constexpr since C++20) |
template< class ExecutionPolicy,
class ForwardIt1, class ForwardIt2, class T,
class BinaryOp, class UnaryOp >
ForwardIt2 transform_exclusive_scan
( ExecutionPolicy&& policy,
ForwardIt1 first, ForwardIt1 last, ForwardIt2 d_first, T init,
BinaryOp binary_op, UnaryOp unary_op );
|
(2) | (since C++17) |
op.i в [0, std::distance(first, last)), выполняет следующие операции по порядку:
- Создает последовательность, которая образована
initза которой следуют значения, преобразованные из элементов[first,iter)по порядку с помощьюunary_op, гдеiterявляется следующимi-й итератор .firstВычисляет обобщенную некоммутативную сумму последовательности над - .
binary_opПрисваивает результат - , где
*destявляется следующимdest-й итераторi.2)d_firstТо же, что и
policy:
true(since C++20)|
|
Обобщенная |
|
|
обобщенная некоммутативная сумма |
последовательности элементов над бинарной операцией определяется следующим образом:
Если последовательность содержит только один элемент, сумма равна значению этого элемента.binary_opВ противном случае выполняет следующие операции по порядку:
- Выбирает любые два соседних элемента
- и
- из последовательности.
elem1Вычисляетelem2и заменяет два элемента в последовательности результатом. - Повторяет шаги 1 и 2, пока в последовательности не останется только один элемент.
binary_op(elem1, elem2) - Результат недетерминирован, если
не является ассоциативной (например, сложение с плавающей запятой).
binary_opЕсли любое из следующих значений не конвертируется в
, программа является некорректной:
TЕсли любое из следующих условий выполнено, поведение неопределено:
binary_op(init, init)binary_op(init, unary_op(*first))binary_op(unary_op(*first), unary_op(*first))
не является
TMoveConstructible. илиunary_opизменяет любой элементbinary_op.[first,last)илиunary_opделает недействительным любой итератор или поддиапазонbinary_op.[first,last]
Параметры
| first, last | - | пара итераторов, определяющих диапазон элементов для суммирования |
| d_first | - | начало целевого диапазона, может быть равно first |
| policy | - | политика выполнения для использования |
| init | - | начальное значение |
| unary_op | - | унарный FunctionObject , который будет применен к каждому элементу входного диапазона. Тип возвращаемого значения должен быть допустимым для ввода в binary_op . |
| binary_op | - | бинарный FunctionObject , который будет применен к результату unary_op , результатам других binary_op и init . |
| Требования к типам | ||
-
InputIt
должен удовлетворять требованиям
LegacyInputIterator
.
|
||
-
OutputIt
должен удовлетворять требованиям
LegacyOutputIterator
.
|
||
-
ForwardIt1, ForwardIt2
должен удовлетворять требованиям
LegacyForwardIterator
.
|
||
Возвращаемое значение
Итератор на элемент, следующий за последним записанным элементом.
Сложность
Дано N как std:: distance ( first, last ) :
Исключения
Перегрузка с параметром шаблона с именем
ExecutionPolicy
сообщает об ошибках следующим образом:
-
Если выполнение функции, вызванной как часть алгоритма, выбрасывает исключение и
ExecutionPolicyявляется одним из стандартных политик , std::terminate вызывается. Для любой другойExecutionPolicyповедение определяется реализацией. - Если алгоритму не удается выделить память, std::bad_alloc выбрасывается.
Примечания
unary_op никогда не применяется к init .
Пример
#include <functional> #include <iostream> #include <iterator> #include <numeric> #include <vector> int main() { std::vector data{3, 1, 4, 1, 5, 9, 2, 6}; auto times_10 = [](int x) { return x * 10; }; std::cout << "10 times exclusive sum: "; std::transform_exclusive_scan(data.begin(), data.end(), std::ostream_iterator<int>(std::cout, " "), 0, std::plus<int>{}, times_10); std::cout << "\n10 times inclusive sum: "; std::transform_inclusive_scan(data.begin(), data.end(), std::ostream_iterator<int>(std::cout, " "), std::plus<int>{}, times_10); std::cout << '\n'; }
Вывод:
10 times exclusive sum: 0 30 40 80 90 140 230 250 10 times inclusive sum: 30 40 80 90 140 230 250 310
Смотрите также
|
вычисляет частичную сумму элементов диапазона
(шаблон функции) |
|
|
(C++17)
|
аналогично
std::partial_sum
, исключает
i
й
входной элемент из
i
й
суммы
(шаблон функции) |
|
(C++17)
|
применяет вызываемый объект, затем вычисляет инклюзивное сканирование
(шаблон функции) |