Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C++

std::for_each: volání funkce pro každý prvek

std::for_each zavolá funkci pro každý prvek v [first, last); sekvenční forma zachovává pořadí a vrací objekt funkce.

Verze: C++23

Syntaxe

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ávě jednou pro každý z N prvků, od first v pořadí rozsahu. Je-li iterátor měnitelný, funkce může prvek změnit. Přetížení bez politiky je constexpr, vyžaduje přesunem konstruovatelný Function a vrací f; přetížení s politikou vyžaduje kopírovatelný Function, může měnit pořadí volání a vrací void.

Příklad sčítá hodnoty v externí proměnné, zdvojnásobí každý prvek a vypíše 6 2 4 6. Návratová hodnota operator() se ignoruje. Pro prázdný rozsah se funkce nezavolá. Externí součet záměrně nepředpokládá, že se stav libovolných kopií objektu funkce sloučí.

Algoritmy mohou objekty funkcí kopírovat; záleží-li na identitě, použijte std::ref nebo dostatečně dlouho žijící externí stav. Bez politiky se výjimka z f šíří a dřívější prvky už mohou být změněny. Se standardní politikou vede k std::terminate; nedostatek paměti může vyvolat std::bad_alloc. Nesynchronizovaná paralelní změna sdíleného stavu je data race; unsequenced politiky navíc zakazují operace nebezpečné pro vektorizaci.

Pří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ýsledek

6 2 4 6

std::for_each → 6 2 4 6

Zdroje