Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C++

std::for_each: volanie funkcie pre každý prvok

std::for_each zavolá funkciu pre každý prvok v [first, last); sekvenčná forma zachováva poradie a vracia objekt funkcie.

Verzia: C++23

Syntax

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) z <algorithm> zavolá f(*i) práve raz pre každý z N prvkov, od first v poradí rozsahu. Ak je iterátor meniteľný, funkcia môže prvok zmeniť. Preťaženie bez politiky je constexpr, vyžaduje presunom konštruovateľný Function a vracia f; preťaženie s politikou vyžaduje kopírovateľný Function, môže meniť poradie volaní a vracia void.

Príklad sčítava hodnoty v externej premennej, zdvojnásobí každý prvok a vypíše 6 2 4 6. Návratová hodnota operator() sa ignoruje. Pre prázdny rozsah sa funkcia nezavolá. Externý súčet zámerne nepredpokladá, že sa stav ľubovoľných kópií objektu funkcie zlúči.

Algoritmy môžu objekty funkcií kopírovať; ak záleží na identite, použite std::ref alebo dostatočne dlho žijúci externý stav. Bez politiky sa výnimka z f šíri a skoršie prvky už môžu byť zmenené. So štandardnou politikou vedie k std::terminate; nedostatok pamäte môže vyvolať std::bad_alloc. Nesynchronizovaná paralelná zmena zdieľaného stavu je data race; unsequenced politiky navyše zakazujú operácie nebezpečné pre vektorizáciu.

Príklady

#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';
}

Výsledok

6 2 4 6

std::for_each → 6 2 4 6

Zdroje