std::ranges::generate
Определён в заголовочном файле <algorithm> | ||
|---|---|---|
| Сигнатура вызова | ||
template< std::input_or_output_iterator O, std::sentinel_for<O> S,
std::copy_constructible F >
requires std::invocable<F&> && std::indirectly_writable<O, std::invoke_result_t<F&>>
constexpr O
generate( O first, S last, F gen );
| (1) | (начиная с C++20) |
template< class R, std::copy_constructible F >
requires std::invocable<F&> && ranges::output_range<R, std::invoke_result_t<F&>>
constexpr ranges::borrowed_iterator_t<R>
generate( R&& r, F gen );
| (2) | (начиная с C++20) |
1) Присваивает результат последовательных вызовов объекта-функции
gen каждому элементу диапазона [first, last).
2) То же, что и (1), но в качестве диапазона используется
r, как если бы ranges::begin(r) использовался в качестве first, а ranges::end(r) — в качестве last.Описанные на этой странице функциональные сущности являются объектами-функциями алгоритмов (неформально называемыми ниблоидами), то есть:
- При вызове любой из них нельзя указывать явный список аргументов шаблона.
- Ни одна из них не видна при поиске с учётом аргументов.
- Если какая-либо из них найдена посредством обычного неквалифицированного поиска как имя слева от оператора вызова функции, поиск с учётом аргументов подавляется.
Параметры
| first, last | - | пара итератора и сентинела, задающая диапазон изменяемых элементов |
| r | - | диапазон изменяемых элементов |
| gen | - | объект-функция генератора |
Возвращаемое значение
Выходной итератор, равный last.
Сложность
Ровно ranges::distance(first, last) вызовов gen() и операций присваивания.
Возможная реализация
struct generate_fn
{
template<std::input_or_output_iterator O, std::sentinel_for<O> S,
std::copy_constructible F>
requires std::invocable<F&> && std::indirectly_writable<O, std::invoke_result_t<F&>>
constexpr O operator()(O first, S last, F gen) const
{
for (; first != last; *first = std::invoke(gen), ++first)
{}
return first;
}
template<class R, std::copy_constructible F>
requires std::invocable<F&> && ranges::output_range<R, std::invoke_result_t<F&>>
constexpr ranges::borrowed_iterator_t<R> operator()(R&& r, F gen) const
{
return (*this)(ranges::begin(r), ranges::end(r), std::move(gen));
}
};
inline constexpr generate_fn generate {};
|
Пример
#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 device;
static std::mt19937 engine {device()};
return distr(engine);
}
void iota(auto& r, int init)
{
std::ranges::generate(r, [init] mutable { return init++; });
}
void print(std::string_view comment, const auto& v)
{
for (std::cout << comment; int i : v)
std::cout << i << ' ';
std::cout << '\n';
}
int main()
{
std::array<int, 8> v;
std::ranges::generate(v.begin(), v.end(), dice);
print("dice: ", v);
std::ranges::generate(v, dice);
print("dice: ", v);
iota(v, 1);
print("iota: ", v);
}
Возможный вывод:
dice: 4 3 1 6 6 4 5 5 dice: 4 2 5 3 6 2 6 2 iota: 1 2 3 4 5 6 7 8
См. также
|
(C++20) | сохраняет результат N применений функции (объект-функция алгоритма) |
|
(C++20) | присваивает элементам диапазона заданное значение (объект-функция алгоритма) |
|
(C++20) | присваивает значение заданному числу элементов (объект-функция алгоритма) |
|
(C++20) | применяет функцию к диапазону элементов (объект-функция алгоритма) |
|
(C++26) | заполняет диапазон случайными числами, полученными от генератора равномерно распределённых случайных битов (объект-функция алгоритма) |
| присваивает результаты последовательных вызовов функции каждому элементу диапазона (шаблон функции) |
© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/algorithm/ranges/generate
