std::ranges:: generate_n
std::ranges
| Non-modifying sequence operations | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Modifying sequence operations | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Partitioning operations | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Sorting operations | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Binary search operations (on sorted ranges) | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Set operations (on sorted ranges) | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Heap operations | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Minimum/maximum operations | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Permutation operations | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Fold operations | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Operations on uninitialized storage | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Return types | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Определено в заголовочном файле
<algorithm>
|
||
|
Сигнатура вызова
|
||
|
template
<
std::
input_or_output_iterator
O,
std::
copy_constructible
F
>
requires
std::
invocable
<
F
&
>
&&
std::
indirectly_writable
<
O,
std::
invoke_result_t
<
F
&
>>
|
(начиная с C++20) | |
Присваивает результат
последовательных
вызовов функционального объекта
gen
каждому элементу в диапазоне
[
first
,
first
+
n
)
, если
0
<
n
. В противном случае ничего не делает.
Функциональные сущности, описанные на этой странице, являются algorithm function objects (неформально известными как niebloids ), то есть:
- Явные списки аргументов шаблона не могут быть указаны при вызове любого из них.
- Ни один из них не видим для поиска, зависимого от аргументов .
- Когда любой из них найден обычным поиском без квалификации как имя слева от оператора вызова функции, поиск, зависимый от аргументов блокируется.
Содержание |
Параметры
| first | - | начало диапазона элементов для модификации |
| n | - | количество элементов для модификации |
| gen | - | функциональный объект-генератор |
Возвращаемое значение
Итератор на элемент, следующий за последним присвоенным, если 0 < count , first в противном случае.
Сложность
Ровно n вызовов gen ( ) и присваиваний.
Возможная реализация
struct generate_n_fn { template<std::input_or_output_iterator O, std::copy_constructible F> requires std::invocable<F&> && std::indirectly_writable<O, std::invoke_result_t<F&>> constexpr O operator()(O first, std::iter_difference_t<O> n, F gen) const { for (; n-- > 0; *first = std::invoke(gen), ++first) {} return first; } }; inline constexpr generate_n_fn generate_n {}; |
Пример
#include <algorithm> #include <array> #include <iostream> #include <random> #include <string_view> auto dice() { static std::uniform_int_distribution<int> distr {1, 6}; static std::random_device engine; static std::mt19937 noise {engine()}; return distr(noise); } void print(const auto& v, std::string_view comment) { for (int i : v) std::cout << i << ' '; std::cout << '(' << comment << ")\n"; } int main() { std::array<int, 8> v; std::ranges::generate_n(v.begin(), v.size(), dice); print(v, "dice"); std::ranges::generate_n(v.begin(), v.size(), [n {0}] mutable { return n++; }); // same effect as std::iota(v.begin(), v.end(), 0); print(v, "iota"); }
Возможный вывод:
5 5 2 2 6 6 3 5 (dice) 0 1 2 3 4 5 6 7 (iota)
Смотрите также
|
(C++20)
|
сохраняет результат функции в диапазоне
(объект-функция алгоритма) |
|
(C++26)
|
заполняет диапазон случайными числами из равномерного генератора случайных битов
(объект-функция алгоритма) |
|
(C++20)
|
присваивает диапазону элементов определенное значение
(объект-функция алгоритма) |
|
(C++20)
|
присваивает значение определенному количеству элементов
(объект-функция алгоритма) |
|
(C++20)
|
применяет функцию к диапазону элементов
(объект-функция алгоритма) |
|
присваивает результаты последовательных вызовов функции N элементам в диапазоне
(шаблон функции) |