Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C++

std::for_each: invocar una función para cada elemento

std::for_each invoca una función para cada elemento de [first, last); la forma secuencial conserva el orden y devuelve el objeto función.

Versión: C++23

Sintaxis

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) de <algorithm> llama a f(*i) exactamente una vez para cada uno de los N elementos, desde first en el orden del rango. Si el iterador es modificable, la función puede cambiar el elemento. La sobrecarga sin política es constexpr, exige un Function construible por movimiento y devuelve f; la que recibe política exige que sea copiable, puede reordenar llamadas y devuelve void.

El ejemplo acumula valores en una variable externa, duplica cada elemento e imprime 6 2 4 6. Se ignora cualquier valor devuelto por operator(). Para un rango vacío no se invoca la función. La suma externa evita deliberadamente suponer que se combinará el estado de copias arbitrarias del objeto función.

Los algoritmos pueden copiar objetos función; si importa la identidad, usa std::ref o estado externo con vida suficiente. Sin política, una excepción de f se propaga y elementos anteriores pueden haber cambiado. Con política estándar, llama a std::terminate; la memoria temporal puede fallar con std::bad_alloc. Modificar estado compartido en paralelo sin sincronización causa una carrera de datos; las políticas unsequenced además prohíben operaciones inseguras para vectorización.

Ejemplos

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

Resultado

6 2 4 6

std::for_each → 6 2 4 6

Fuentes