std::ranges::generate_random

template< class R, class G >
    requires ranges::output_range<R, std::invoke_result_t<G&>> &&
             std::uniform_random_bit_generator<std::remove_cvref_t<G>>
constexpr ranges::borrowed_iterator_t<R>
    generate_random( R&& r, G&& g );

template< class G, std::output_iterator<std::invoke_result_t<G&>> O,
          std::sentinel_for<O> S >
    requires std::uniform_random_bit_generator<std::remove_cvref_t<G>>
constexpr O
    generate_random( O first, S last, G&& g );

template< class R, class G, class D >
    requires ranges::output_range<R, std::invoke_result_t<D&, G&>> &&
             std::invocable<D&, G&> &&
             std::uniform_random_bit_generator<std::remove_cvref_t<G>> &&
             std::is_arithmetic_v<std::invoke_result_t<D&, G&>>
constexpr ranges::borrowed_iterator_t<R>
    generate_random( R&& r, G&& g, D&& d );

template< class G, class D, std::output_iterator<std::invoke_result_t<D&, G&>> O,
          std::sentinel_for<O> S >
    requires std::invocable<D&, G&> &&
             std::uniform_random_bit_generator<std::remove_cvref_t<G>> &&
             std::is_arithmetic_v<std::invoke_result_t<D&, G&>>
constexpr O
    generate_random( O first, S last, G&& g, D&& d );

Пытается генерировать случайные числа с помощьюgenerate_randomфункции-члена генератора случайных чисел или распределения, которая, как ожидается, будет более эффективной. Переходит к поэлементной генерации, если функция-член generate_random недоступна.

Пусть операция запасного варианта — вызов ranges::generate(std::forward<R>(r), std::ref(g)) или ranges::generate(std::forward<R>(r), [&d, &g] { return std::invoke(d, g); }) для (1) или (3) соответственно.

Если эффекты (1) или (3) не эквивалентны эффектам соответствующей операции запасного варианта, поведение не определено.

Значение N может различаться между вызовами. Реализации могут выбирать меньшие значения для более коротких диапазонов.

Объекты, подобные функциям, описанные на этой странице, являются объектами функций алгоритмов (неформально известными как niebloids), то есть:

• При их вызове нельзя указывать явные списки аргументов шаблона.
• Ни один из них не видим при поиске, зависящем от аргументов.
• Когда любой из них находится с помощью обычного неквалифицированного поиска как имя слева от оператора вызова функции, поиск, зависящий от аргументов, подавляется.

Параметры

Примечания

На момент стандартизации std::ranges::generate_random в стандартной библиотеке не существует генератора случайных чисел или распределения, которые предоставляют функцию-член generate_random .

std::ranges::generate_random может быть более эффективным при использовании с пользовательским генератором случайных чисел, который оборачивает базовый векторизованный API.

Пример

#include <algorithm>
#include <iomanip>
#include <iostream>
#include <random>
int main()
{
    std::default_random_engine eng;
    std::default_random_engine::result_type rs[16]{};
    std::ranges::generate_random(rs, eng);
    std::cout << std::left;
    for (int i{}; auto n : rs)
        std::cout << std::setw(11) << n << (++i % 4 ? ' ' : '\n');
}

16807       282475249   1622650073  984943658 
1144108930  470211272   101027544   1457850878
1458777923  2007237709  823564440   1115438165
1784484492  74243042    114807987   1137522503

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