класс Random

static VALUE
random_s_bytes(VALUE obj, VALUE len)
{
    rb_random_t *rnd = rand_start(default_rand());
    return rand_bytes(&random_mt_if, rnd, NUM2LONG(rb_to_int(len)));
}

Возвращает случайную двоичную строку. Аргумент size определяет длину возвращаемой строки.

static VALUE
random_init(int argc, VALUE *argv, VALUE obj)
{
    rb_random_t *rnd = try_get_rnd(obj);
    const rb_random_interface_t *rng = rb_rand_if(obj);

    if (!rng) {
        rb_raise(rb_eTypeError, "undefined random interface: %s",
                 RTYPEDDATA_TYPE(obj)->wrap_struct_name);
    }

    unsigned int major = rng->version.major;
    unsigned int minor = rng->version.minor;
    if (major != RUBY_RANDOM_INTERFACE_VERSION_MAJOR) {
        rb_raise(rb_eTypeError, "Random interface version "
                 STRINGIZE(RUBY_RANDOM_INTERFACE_VERSION_MAJOR) "."
                 STRINGIZE(RUBY_RANDOM_INTERFACE_VERSION_MINOR) " "
                 "expected: %d.%d", major, minor);
    }
    argc = rb_check_arity(argc, 0, 1);
    rb_check_frozen(obj);
    if (argc == 0) {
        rnd->seed = rand_init_default(rng, rnd);
    }
    else {
        rnd->seed = rand_init(rng, rnd, rb_to_int(argv[0]));
    }
    return obj;
}

Создаёт новый PRNG, используя seed для задания начального состояния. Если seed опущено, генератор инициализируется с помощью Random.new_seed.

См. Random.srand для получения дополнительной информации об использовании значений seed.

static VALUE
random_seed(VALUE _)
{
    VALUE v;
    with_random_seed(DEFAULT_SEED_CNT, 1, true) {
        v = make_seed_value(seedbuf, DEFAULT_SEED_CNT);
    }
    return v;
}

Возвращает произвольное значение seed. Оно используется Random.new, когда значение seed не указано в качестве аргумента.

Random.new_seed  #=> 115032730400174366788466674494640623225

static VALUE
random_s_rand(int argc, VALUE *argv, VALUE obj)
{
    VALUE v = rand_random(argc, argv, Qnil, rand_start(default_rand()));
    check_random_number(v, argv);
    return v;
}

Возвращает случайное число, используя Ruby-систему PRNG.

См. также Random#rand.

static VALUE
random_s_seed(VALUE obj)
{
    rb_random_mt_t *rnd = rand_mt_start(default_rand());
    return rnd->base.seed;
}

Возвращает значение seed, используемое для инициализации Ruby-системы PRNG. Оно может быть использовано для инициализации другого генератора с тем же состоянием в более позднее время, что приведет к созданию той же последовательности чисел.

Random.seed      #=> 1234
prng1 = Random.new(Random.seed)
prng1.seed       #=> 1234
prng1.rand(100)  #=> 47
Random.seed      #=> 1234
Random.rand(100) #=> 47

static VALUE
rb_f_srand(int argc, VALUE *argv, VALUE obj)
{
    VALUE seed, old;
    rb_random_mt_t *r = rand_mt_start(default_rand());

    if (rb_check_arity(argc, 0, 1) == 0) {
        seed = random_seed(obj);
    }
    else {
        seed = rb_to_int(argv[0]);
    }
    old = r->base.seed;
    rand_init(&random_mt_if, &r->base, seed);
    r->base.seed = seed;

    return old;
}

Инициализирует генератор псевдослучайных чисел системы, с помощью number. Возвращается предыдущее значение seed.

Если number опущено, генератор инициализируется с использованием источника энтропии, предоставленного операционной системой (если доступно /dev/urandom на системах Unix или криптографический поставщик RSA на Windows), который затем комбинируется со временем, идентификатором процесса и номером последовательности.

srand может быть использован для обеспечения воспроизводимости последовательностей псевдослучайных чисел при разных запусках программы. Установив значение seed, программы могут быть сделаны детерминированными во время тестирования.

srand 1234               # => 268519324636777531569100071560086917274
[ rand, rand ]           # => [0.1915194503788923, 0.6221087710398319]
[ rand(10), rand(1000) ] # => [4, 664]
srand 1234               # => 1234
[ rand, rand ]           # => [0.1915194503788923, 0.6221087710398319]

static VALUE
random_raw_seed(VALUE self, VALUE size)
{
    long n = NUM2ULONG(size);
    VALUE buf = rb_str_new(0, n);
    if (n == 0) return buf;
    if (fill_random_bytes(RSTRING_PTR(buf), n, TRUE))
        rb_raise(rb_eRuntimeError, "failed to get urandom");
    return buf;
}

Возвращает строку, используя функции платформы. Ожидается, что возвращаемое значение является криптографически безопасным псевдослучайным числом в двоичном формате. Данный метод генерирует RuntimeError если функция платформы не смогла подготовить результат.

В 2017 году в manpage Linux random(7) было указано, что «никакой криптографический примитив, доступный сегодня, не может надеяться на больше, чем 256 бит безопасности». Поэтому может быть сомнительно передавать size > 32 в этот метод.

Random.urandom(8)  #=> "\x78\x41\xBA\xAF\x7D\xEA\xD8\xEA"