std:: for_each

Aplica el objeto de función unario dado function object f al resultado de desreferenciar cada iterator en el range [ first , last ) . Si f retorna un resultado, el resultado es ignorado.

Si el tipo de iterador ( InputIt / ForwardIt ) es mutable, f puede modificar los elementos del rango a través del iterador desreferenciado.

A diferencia del resto de los algoritmos paralelos, for_each no está permitido hacer copias de los elementos en la secuencia incluso si son TriviallyCopyable .

Parámetros

Valor de retorno

Complejidad

Exactamente std:: distance ( first, last ) aplicaciones de f .

Excepciones

La sobrecarga con un parámetro de plantilla llamado ExecutionPolicy reporta errores de la siguiente manera:

• Si la ejecución de una función invocada como parte del algoritmo lanza una excepción y ExecutionPolicy es uno de los standard policies , std::terminate es llamado. Para cualquier otro ExecutionPolicy , el comportamiento está definido por la implementación.
• Si el algoritmo falla al asignar memoria, std::bad_alloc es lanzado.

Implementación posible

Consulte también las implementaciones en libstdc++ , libc++ y 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; // movimiento implícito desde C++11
}

Notas

Para la sobrecarga ( 1 ) , f puede ser un objeto función con estado. El valor de retorno puede considerarse como el estado final de la operación por lotes.

Para la sobrecarga ( 2 ) , pueden crearse múltiples copias de f para realizar invocación paralela. No se devuelve ningún valor porque la paralelización frecuentemente no permite una acumulación eficiente de estado.

Ejemplo

#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

Informes de defectos

Los siguientes informes de defectos que modifican el comportamiento se aplicaron retroactivamente a los estándares de C++ publicados anteriormente.

Véase también