std:: for_each_n

Applique l'objet fonction donné f au résultat de la déréférenciation de chaque itérateur dans l'intervalle [ first , first + n ) . Si f retourne un résultat, ce résultat est ignoré.

Si n >= 0 n'est pas true , le comportement est indéfini.

Si le type d'itérateur ( InputIt / ForwardIt ) est mutable, f peut modifier les éléments de la plage via l'itérateur déréférencé.

Contrairement aux autres algorithmes parallèles, for_each_n n'est pas autorisé à effectuer des copies des éléments dans la séquence même s'ils sont TriviallyCopyable .

Paramètres

Valeur de retour

Un itérateur égal à first + n , ou plus formellement, à std:: advance ( first, n ) .

Complexité

Exactement n applications de f .

Exceptions

La surcharge avec un paramètre de modèle nommé ExecutionPolicy signale les erreurs comme suit :

• Si l'exécution d'une fonction invoquée dans le cadre de l'algorithme lève une exception et que ExecutionPolicy fait partie des politiques standard , std::terminate est appelé. Pour tout autre ExecutionPolicy , le comportement est défini par l'implémentation.
• Si l'algorithme ne parvient pas à allouer de la mémoire, std::bad_alloc est levé.

Implémentation possible

Voir également l'implémentation dans libstdc++ , libc++ et 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;
}

Exemple

#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

Voir aussi