Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::for_each: wywołanie funkcji dla każdego elementu

std::for_each wywołuje funkcję dla każdego elementu [first, last); wersja sekwencyjna zachowuje kolejność i zwraca obiekt funkcji.

Wersja: C++23

Składnia

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> wywołuje f(*i) dokładnie raz dla każdego z N elementów, od first do końca w kolejności zakresu. Jeśli iterator jest modyfikowalny, funkcja może zmieniać element. Przeciążenie bez polityki jest constexpr, wymaga przenośnie konstruowalnego Function i zwraca f; przeciążenie z polityką wymaga kopiowalnego Function, może zmienić kolejność i zwraca void.

Przykład sumuje wartości w zewnętrznej zmiennej, podwaja każdy element i drukuje 6 2 4 6. Wartość zwracana przez operator() jest ignorowana. Dla pustego zakresu funkcja nie jest wywoływana. Zewnętrzna suma celowo unika założenia, że stan dowolnych kopii funktora zostanie połączony.

Algorytmy mogą kopiować obiekty funkcyjne; gdy ważna jest ich tożsamość, użyj std::ref albo stanu zewnętrznego o właściwym czasie życia. Bez polityki wyjątek z f jest propagowany i wcześniejsze elementy mogą już być zmienione. Przy standardowej polityce nieprzechwycony wyjątek wywołuje std::terminate, a pamięć tymczasowa może zgłosić std::bad_alloc. Równoległa modyfikacja wspólnego stanu bez synchronizacji tworzy wyścig danych; polityki unsequenced dodatkowo zabraniają operacji niebezpiecznych dla wektoryzacji.

Przykłady

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

Wynik

6 2 4 6

std::for_each → 6 2 4 6

Źródła