Spec-Zone.ru › C++

std::generate_canonical

Определено в заголовке <random>
template< class RealType, std::size_t Bits, class Generator >
RealType generate_canonical( Generator& g );
(с C++11)

Генерирует случайное число с плавающей точкой в диапазоне [​0​, 1).

Для генерации достаточного количества энтропии, generate_canonical() вызовет g() ровно \(\small k\) раз, где \(\small k = \max(1, \lceil \frac{b}{\log_2 R} \rceil)\) и

  • b = std::min(Bits, std::size_t {std::numeric_limits<RealType>::digits}),
  • R = g.max() - g.min() + 1.

Параметры

g - генератор для получения энтропии

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

Значение с плавающей точкой в диапазоне [​0​, 1).

Исключения

Никакие, кроме тех, которые могут быть брошены g.

Примечания

В некоторых существующих реализациях может быть ошибка, из-за которой иногда возвращается 1.0 если RealType равно float GCC #63176 LLVM #18767 MSVC STL #1074. Это проблема LWG 2524.

Пример

Произведите случайные числа с 10 битами случайности: это может произвести только k * R различных значений.

#include <iostream>
#include <random>
 
int main()
{
    std::random_device rd;
    std::mt19937 gen(rd());
    for (int n = 0; n < 10; ++n)
        std::cout << std::generate_canonical<double, 10>(gen) << ' ';
    std::cout << '\n';
}

Возможный результат:

0.208143 0.824147 0.0278604 0.343183 0.0173263 0.864057 0.647037 0.539467 0.0583497 0.609219

См. также

uniform_real_distribution
(C++11)
производит вещественные значения, равномерно распределенные по диапазону
(шаблон класса)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/numeric/random/generate_canonical

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API