База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C++

std::for_each: извикване на функция за всеки елемент

std::for_each извиква функция за всеки елемент в [first, last); последователната форма пази реда и връща функционалния обект.

Версия: C++23

Синтаксис

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) от <algorithm> извиква f(*i) точно веднъж за всеки от N елемента, от first по реда на диапазона. Ако итераторът е променяем, функцията може да промени елемента. Претоварването без политика е constexpr, изисква преместваемо конструируем Function и връща f; формата с политика изисква копируем Function, може да пренарежда извикванията и връща void.

Примерът сумира стойностите във външна променлива, удвоява всеки елемент и извежда 6 2 4 6. Върната стойност от operator() се игнорира. При празен диапазон функцията не се извиква. Външната сума нарочно не допуска, че състоянието на произволни копия на функционалния обект ще бъде обединено.

Алгоритмите могат да копират функционални обекти; когато идентичността е важна, използвайте std::ref или външно състояние с достатъчен живот. Без политика изключение от f се разпространява и по-ранни елементи може вече да са променени. При стандартна политика води до std::terminate; недостигът на памет може да хвърли std::bad_alloc. Несинхронизираната паралелна промяна на споделено състояние е data race; unsequenced политиките забраняват и операции, опасни за векторизация.

Примери

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

Резултат

6 2 4 6

std::for_each → 6 2 4 6

Източници