Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C++

std::for_each: klic funkcije za vsak element

std::for_each pokliče funkcijo za vsak element v [first, last); zaporedna oblika ohrani vrstni red in vrne funkcijski objekt.

Različica: C++23

Sintaksa

template<class InputIterator, class Function>
constexpr Function std::for_each(
    InputIterator first, InputIterator last, Function f);

template<class ExecutionPolicy, class ForwardIterator, class Function>
void std::for_each(ExecutionPolicy&& exec,
    ForwardIterator first, ForwardIterator last, Function f);

std::for_each(first, last, f) iz <algorithm> pokliče f(*i) natanko enkrat za vsakega od N elementov, od first po vrstnem redu območja. Če je iterator spremenljiv, lahko funkcija spremeni element. Preobremenitev brez politike je constexpr, zahteva premakljivo konstruiran Function in vrne f; oblika s politiko zahteva kopirljiv Function, lahko preuredi klice in vrne void.

Primer sešteje vrednosti v zunanji spremenljivki, podvoji vsak element in izpiše 6 2 4 6. Vrnjen rezultat operator() se prezre. Pri praznem območju se funkcija ne pokliče. Zunanja vsota namenoma ne predpostavlja, da se stanje poljubnih kopij funkcijskega objekta združi.

Algoritmi lahko kopirajo funkcijske objekte; če je pomembna identiteta, uporabite std::ref ali dovolj dolgo živeče zunanje stanje. Brez politike se izjema iz f razširi in prejšnji elementi so lahko že spremenjeni. S standardno politiko vodi v std::terminate; pomanjkanje pomnilnika lahko vrže std::bad_alloc. Nesinhronizirana vzporedna sprememba skupnega stanja je data race; unsequenced politike prepovedujejo tudi operacije, nevarne za vektorizacijo.

Primeri

#include <algorithm>
#include <array>
#include <iostream>

int main() {
    std::array values{1, 2, 3};
    int sum = 0;
    std::for_each(values.begin(), values.end(), [&](int& value) {
        sum += value;
        value *= 2;
    });
    std::cout << sum;
    for (int value : values) {
        std::cout << ' ' << value;
    }
    std::cout << '\n';
}

Rezultat

6 2 4 6

std::for_each → 6 2 4 6

Viri