std:: for_each_n

Aplica el objeto de función dado f al resultado de desreferenciar cada iterador en el rango [ first , first + n ) . Si f devuelve un resultado, este se ignora.

Si n >= 0 no es true , el comportamiento es indefinido.

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_n no está permitido hacer copias de los elementos en la secuencia incluso si son TriviallyCopyable .

Parámetros

Valor de retorno

Un iterador igual a first + n , o más formalmente, a std:: advance ( first, n ) .

Complejidad

Exactamente n 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 la implementación en libstdc++ , libc++ y MSVC stdlib .

template<class InputIt, class Size, class UnaryFunc>
InputIt for_each_n(InputIt first, Size n, UnaryFunc f)
{
    for (Size i = 0; i < n; ++first, (void) ++i)
        f(*first);
    return first;
}

Ejemplo

#include <algorithm>
#include <iostream>
#include <vector>
void println(auto const& v)
{
    for (auto count{v.size()}; const auto& e : v)
        std::cout << e << (--count ? ", " : "\n");
}
int main()
{
    std::vector<int> vi{1, 2, 3, 4, 5};
    println(vi);
    std::for_each_n(vi.begin(), 3, [](auto& n) { n *= 2; });
    println(vi);
}

1, 2, 3, 4, 5
2, 4, 6, 4, 5

Véase también