std:: for_each

Применяет заданный унарный функциональный объект f к результату разыменования каждого итератора в диапазоне [ first , last ) . Если f возвращает результат, он игнорируется.

Если тип итератора ( InputIt / ForwardIt ) является изменяемым, f может модифицировать элементы диапазона через разыменованный итератор.

В отличие от остальных параллельных алгоритмов, for_each не разрешается создавать копии элементов в последовательности, даже если они являются TriviallyCopyable .

Параметры

Возвращаемое значение

Сложность

Ровно std:: distance ( first, last ) применений функции f .

Исключения

Перегрузка с параметром шаблона с именем ExecutionPolicy сообщает об ошибках следующим образом:

• Если выполнение функции, вызванной как часть алгоритма, выбрасывает исключение и ExecutionPolicy является одним из стандартных политик , std::terminate вызывается. Для любой другой ExecutionPolicy поведение определяется реализацией.
• Если алгоритму не удается выделить память, std::bad_alloc выбрасывается.

Возможная реализация

Смотрите также реализации в libstdc++ , libc++ и MSVC stdlib .

template<class InputIt, class UnaryFunc>
constexpr UnaryFunc for_each(InputIt first, InputIt last, UnaryFunc f)
{
    for (; first != last; ++first)
        f(*first);
    return f; // неявное перемещение начиная с C++11
}

Примечания

Для перегрузки ( 1 ) , f может быть функциональным объектом с состоянием. Возвращаемое значение может рассматриваться как конечное состояние пакетной операции.

Для перегрузки ( 2 ) может быть создано несколько копий f для выполнения параллельного вызова. Значение не возвращается, поскольку параллелизация часто не позволяет эффективно накапливать состояние.

Пример

#include <algorithm>
#include <iostream>
#include <vector>
int main()
{
    std::vector<int> v{3, -4, 2, -8, 15, 267};
    auto print = [](const int& n) { std::cout << n << ' '; };
    std::cout << "before:\t";
    std::for_each(v.cbegin(), v.cend(), print);
    std::cout << '\n';
    // increment elements in-place
    std::for_each(v.begin(), v.end(), [](int &n) { n++; });
    std::cout << "after:\t";
    std::for_each(v.cbegin(), v.cend(), print);
    std::cout << '\n';
    struct Sum
    {
        void operator()(int n) { sum += n; }
        int sum {0};
    };
    // invoke Sum::operator() for each element
    Sum s = std::for_each(v.cbegin(), v.cend(), Sum());    
    std::cout << "sum:\t" << s.sum << '\n';
}

before:	3 -4 2 -8 15 267 
after:	4 -3 3 -7 16 268 
sum:	281

Отчёты о дефектах

Следующие отчеты об изменениях поведения, влияющие на дефекты, были применены ретроактивно к ранее опубликованным стандартам C++.

Смотрите также