модуль Random::Formatter

# File lib/securerandom.rb, line 137
def base64(n=nil)
  [random_bytes(n)].pack("m*").delete("\n")
end

SecureRandom.base64 генерирует случайную строку base64.

Аргумент n задаёт длину, в байтах, случайного числа, которое нужно сгенерировать. Длина результирующей строки составляет примерно 4/3 от n.

Если n не указан или равен nil, предполагается значение 16. В будущем оно может быть больше.

Результат может содержать символы A-Z, a-z, 0-9, “+”, “/” и “=”.

p SecureRandom.base64 #=> "/2BuBuLf3+WfSKyQbRcc/A=="
p SecureRandom.base64 #=> "6BbW0pxO0YENxn38HMUbcQ=="

Если генератор безопасных случайных чисел недоступен, NotImplementedError будет вызвано.

См. RFC 3548 для определения base64.

# File lib/securerandom.rb, line 116
def hex(n=nil)
  random_bytes(n).unpack("H*")[0]
end

SecureRandom.hex генерирует случайную шестнадцатеричную строку.

Аргумент n задаёт длину, в байтах, случайного числа, которое нужно сгенерировать. Длина результирующей шестнадцатеричной строки равна удвоенному значению n.

Если n не указан или равен nil, предполагается значение 16. В будущем оно может быть больше.

Результат может содержать символы 0-9 и a-f.

p SecureRandom.hex #=> "eb693ec8252cd630102fd0d0fb7c3485"
p SecureRandom.hex #=> "91dc3bfb4de5b11d029d376634589b61"

Если генератор безопасных случайных чисел недоступен, NotImplementedError будет вызвано.

# File lib/securerandom.rb, line 96
def random_bytes(n=nil)
  n = n ? n.to_int : 16
  gen_random(n)
end

SecureRandom.random_bytes генерирует случайную двоичную строку.

Аргумент n задаёт длину результирующей строки.

Если n не указан или равен nil, предполагается значение 16. В будущем оно может быть больше.

Результат может содержать любые байты: “x00” - “xff”.

p SecureRandom.random_bytes #=> "\xD8\\\xE0\xF4\r\xB2\xFC*WM\xFF\x83\x18\xF45\xB6"
p SecureRandom.random_bytes #=> "m\xDC\xFC/\a\x00Uf\xB2\xB2P\xBD\xFF6S\x97"

Если генератор безопасных случайных чисел недоступен, NotImplementedError будет вызвано.

# File lib/securerandom.rb, line 167
def urlsafe_base64(n=nil, padding=false)
  s = [random_bytes(n)].pack("m*")
  s.delete!("\n")
  s.tr!("+/", "-_")
  s.delete!("=") unless padding
  s
end

SecureRandom.urlsafe_base64 генерирует случайную строку URL-безопасной base64.

Аргумент n задаёт длину, в байтах, случайного числа, которое нужно сгенерировать. Длина результирующей строки составляет примерно 4/3 от n.

Если n не указан или равен nil, предполагается значение 16. В будущем оно может быть больше.

Булевый аргумент padding задаёт необходимость добавления заполнения. Если он равен false или nil, заполнение не генерируется. В противном случае заполнение генерируется. По умолчанию заполнение не генерируется, поскольку “=” может использоваться как разделитель в URL.

Результат может содержать символы A-Z, a-z, 0-9, “-” и “_”. Также используется “=” при padding = true.

p SecureRandom.urlsafe_base64 #=> "b4GOKm4pOYU_-BOXcrUGDg"
p SecureRandom.urlsafe_base64 #=> "UZLdOkzop70Ddx-IJR0ABg"

p SecureRandom.urlsafe_base64(nil, true) #=> "i0XQ-7gglIsHGV2_BNPrdQ=="
p SecureRandom.urlsafe_base64(nil, true) #=> "-M8rLhr7JEpJlqFGUMmOxg=="

Если генератор безопасных случайных чисел недоступен, NotImplementedError будет вызвано.

См. RFC 3548 для определения URL-безопасной base64.

# File lib/securerandom.rb, line 235
def uuid
  ary = random_bytes(16).unpack("NnnnnN")
  ary[2] = (ary[2] & 0x0fff) | 0x4000
  ary[3] = (ary[3] & 0x3fff) | 0x8000
  "%08x-%04x-%04x-%04x-%04x%08x" % ary
end

# SecureRandom.random_number generates a random number.
#
# If a positive integer is given as _n_,
# +SecureRandom.random_number+ returns an integer, such that:
# +0 <= SecureRandom.random_number(n) < n+.
#
#   p SecureRandom.random_number(100) #=> 15
#   p SecureRandom.random_number(100) #=> 88
#
# If 0 is given or an argument is not given,
# +SecureRandom.random_number+ returns a float, such that:
# +0.0 <= SecureRandom.random_number() < 1.0+.
#
#   p SecureRandom.random_number #=> 0.596506046187744
#   p SecureRandom.random_number #=> 0.350621695741409
#
def random_number(n=0)
  if 0 < n
    if defined? OpenSSL::BN
      OpenSSL::BN.rand_range(n).to_i
    else
      hex = n.to_s(16)
      hex = '0' + hex if (hex.length & 1) == 1
      bin = [hex].pack("H*")
      mask = bin[0].ord
      mask |= mask >> 1
      mask |= mask >> 2
      mask |= mask >> 4
      begin
        rnd = random_bytes(bin.length)
        rnd[0] = (rnd[0].ord & mask).chr
      end until rnd < bin
      rnd.unpack("H*")[0].hex
    end
  else
    # assumption: Float::MANT_DIG <= 64
    if defined? OpenSSL::BN
      i64 = OpenSSL::BN.rand(64, -1).to_i
    else
      i64 = random_bytes(8).unpack("Q")[0]
    end
    Math.ldexp(i64 >> (64-Float::MANT_DIG), -Float::MANT_DIG)
  end
end

# SecureRandom.uuid генерирует случайный UUID версии 4 (универсальный уникальный идентификатор). # # p SecureRandom.uuid #=> “2d931510-d99f-494a-8c67-87feb05e1594” # p SecureRandom.uuid #=> “bad85eb9-0713-4da7-8d36-07a8e4b00eab” # p SecureRandom.uuid #=> “62936e70-1815-439b-bf89-8492855a7e6b” # # UUID версии 4 полностью случайный (кроме версии). # Он не содержит значимой информации, такой как MAC-адреса, метки времени и т.д. # # Результат содержит 122 случайных бита (15.25 случайных байтов). # # См. RFC 4122 для подробностей о UUID. #