Namespaces
Variants

std:: for_each_n

From cppreference.net
C++
Algorithm library
Constrained algorithms and algorithms on ranges (C++20)
Constrained algorithms, e.g. ranges::copy , ranges::sort , ...
Execution policies (C++17)
Non-modifying sequence operations
Batch operations
for_each_n
(C++17)
Search operations
Modifying sequence operations
Copy operations
(C++11)
(C++11)
(C++11)
Swap operations
Transformation operations
Generation operations
Removing operations
Order-changing operations
(until C++17) (C++11)
(C++20) (C++20)
Sampling operations
(C++17)

Sorting and related operations
Partitioning operations
Sorting operations
Binary search operations
(on partitioned ranges)
Set operations (on sorted ranges)
Merge operations (on sorted ranges)
Heap operations
Minimum/maximum operations
Lexicographical comparison operations
(C++20)
Permutation operations
C library
Numeric operations
Operations on uninitialized memory
Определено в заголовочном файле <algorithm>
template < class InputIt, class Size, class UnaryFunc >
InputIt for_each_n ( InputIt first, Size n, UnaryFunc f ) ;
(1) (начиная с C++17)
(constexpr начиная с C++20)
template < class ExecutionPolicy,

class ForwardIt, class Size, class UnaryFunc >
ForwardIt for_each_n ( ExecutionPolicy && policy,

ForwardIt first, Size n, UnaryFunc f ) ;
(2) (начиная с C++17)

Применяет заданный функциональный объект f к результату разыменования каждого итератора в диапазоне [ first , first + n ) . Если f возвращает результат, он игнорируется.

1) f применяется последовательно, начиная с first .
Если UnaryFunc не является MoveConstructible , поведение не определено.
2) f может применяться не по порядку. Алгоритм выполняется в соответствии с policy .
Эта перегрузка участвует в разрешении перегрузки только при выполнении всех следующих условий:

std:: is_execution_policy_v < std:: decay_t < ExecutionPolicy >> равно true .

(до C++20)

std:: is_execution_policy_v < std:: remove_cvref_t < ExecutionPolicy >> равно true .

(начиная с C++20)
Если UnaryFunc не является CopyConstructible , поведение не определено.

Если n >= 0 не является true , поведение не определено.

Если тип итератора ( InputIt / ForwardIt ) является изменяемым, f может изменять элементы диапазона через разыменованный итератор.

В отличие от остальных параллельных алгоритмов, for_each_n не разрешено создавать копии элементов в последовательности, даже если они являются TriviallyCopyable .

Содержание

Параметры

first - начало диапазона, к которому применяется функция
n - количество элементов, к которым применяется функция
policy - политика выполнения, которая будет использоваться execution policy to use
f - функциональный объект, применяемый к результату разыменования каждого итератора в диапазоне [ first , first + n )

Сигнатура функции должна быть эквивалентна следующей:

void fun ( const Type & a ) ;

Сигнатура не обязательно должна содержать const & .
Тип Type должен быть таким, чтобы объект типа InputIt мог быть разыменован и неявно преобразован в Type .

​

Требования к типам
-
InputIt должен удовлетворять требованиям LegacyInputIterator .
-
ForwardIt должен удовлетворять требованиям LegacyForwardIterator .
-
Size должен быть конвертируемым в целочисленный тип.

Возвращаемое значение

Итератор, равный first + n , или, более формально, std:: advance ( first, n ) .

Сложность

Ровно n применений функции f .

Исключения

Перегрузка с параметром шаблона с именем ExecutionPolicy сообщает об ошибках следующим образом:

  • Если выполнение функции, вызванной как часть алгоритма, выбрасывает исключение и ExecutionPolicy является одним из стандартных политик , std::terminate вызывается. Для любой другой ExecutionPolicy поведение определяется реализацией.
  • Если алгоритму не удается выделить память, std::bad_alloc выбрасывается.

Возможная реализация

Смотрите также реализацию в libstdc++ , libc++ и MSVC stdlib . 

template<class InputIt, class Size, class UnaryFunc>
InputIt for_each_n(InputIt first, Size n, UnaryFunc f)
{
    for (Size i = 0; i < n; ++first, (void) ++i)
        f(*first);
    return first;
}
**Примечание:** Весь код C++ внутри тегов ` 
` и `` оставлен без изменений в соответствии с требованиями. HTML-разметка и атрибуты также сохранены в оригинальном виде.

Пример

Запустить этот код 
#include <algorithm>
#include <iostream>
#include <vector>
void println(auto const& v)
{
    for (auto count{v.size()}; const auto& e : v)
        std::cout << e << (--count ? ", " : "\n");
}
int main()
{
    std::vector<int> vi{1, 2, 3, 4, 5};
    println(vi);
    std::for_each_n(vi.begin(), 3, [](auto& n) { n *= 2; });
    println(vi);
}

Вывод: 

1, 2, 3, 4, 5
2, 4, 6, 4, 5

Смотрите также

применяет функцию к диапазону элементов, сохраняя результаты в целевом диапазоне
(шаблон функции)
range- for loop (C++11) выполняет цикл по диапазону
применяет унарный function object к элементам из range
(шаблон функции)
(C++20)
применяет объект функции к первым N элементам последовательности
(объект функции алгоритма)