std::for_each
Материал из cppreference.com
Определено в заголовочном файле <algorithm> | ||
template<class InputIt, class UnaryFunction > UnaryFunction for_each( InputIt first, InputIt last, UnaryFunction f ); | ||
По порядку применяет заданный функциональный объект f к результату разыменования каждого итератора в диапазоне [first, last). Если InputIt — изменяемый итератор, то f может изменять элементы диапазона через разыменованный итератор. Если f возвращает результат, то он игнорируется.
Содержание |
[править]Параметры
[first, last) | — | два итератора задающих диапазон элементов для применения функции |
| f | — | применяемый унарный функциональный объект |
| Требования к типам | ||
-InputIt должен соответствовать требованиям InputIterator. | ||
-UnaryFunction должен соответствовать требованиям MoveConstructible. Не обязательно CopyConstructible | ||
[править]Возвращаемое значение
f. | (до C++11) |
| std::move(f). | (начиная с C++11) |
[править]Сложность
Ровно last - first применений f.
[править]Возможная реализация
template<class InputIt, class UnaryFunction> UnaryFunction for_each(InputIt first, InputIt last, UnaryFunction f){for(; first != last;++first){ f(*first);}return f;} |
[править]Пример
В следующем примере используется лямбда-функция для инкрементации всех элементов вектора, а затем считается их сумма:
Запустить этот код
#include <vector>#include <algorithm>#include <iostream> struct Sum { Sum(){ sum =0;}void operator()(int n){ sum += n;} int sum;}; int main(){std::vector<int> nums{3, 4, 2, 9, 15, 267}; std::cout<<"до: ";for(auto n : nums){std::cout<< n <<" ";}std::cout<<'\n'; std::for_each(nums.begin(), nums.end(), [](int&n){ n++;}); Sum s = std::for_each(nums.begin(), nums.end(), Sum()); std::cout<<"после: ";for(auto n : nums){std::cout<< n <<" ";}std::cout<<'\n';std::cout<<"сумма: "<< s.sum<<'\n';}
Вывод:
до: 3 4 2 9 15 267 после: 4 5 3 10 16 268 сумма: 306
[править]См. также
| применяет функцию к диапазону элементов, сохраняя результаты в целевом диапазоне (шаблон функции) | |
диапазонный цикл for(C++11) | выполняет цикл по диапазону |
