std::for_each

template< class InputIt, class UnaryFunc >
UnaryFunc for_each( InputIt first, InputIt last, UnaryFunc f );

template< class ExecutionPolicy, class ForwardIt, class UnaryFunc >
void for_each( ExecutionPolicy&& policy,
               ForwardIt first, ForwardIt last, UnaryFunc f );

Aplica el objeto invocable dado f a cada elemento en el rango objetivo [first, last). Si f devuelve un resultado, el resultado se ignora.

Parámetros

Valor devuelto

Complejidad

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

Excepciones

Notas

Si el tipo de iterador (InputIt/ForwardIt) es mutable, f puede modificar los elementos en el rango objetivo.

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

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

Posible implementación

Véase 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; // implicit move since C++11
}

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 cambian el comportamiento se aplicaron retroactivamente a estándares C++ previamente publicados.

Véase también