Random::Formatter

module Random::Formatter

公共实例方法

base64(n=nil) Show source

SecureRandom.base64生成一个随机的base64字符串。

参数n指定要生成的随机数的长度（以字节为单位）。结果字符串的长度约为n的 4/3 。

如果n未被指定或者为零，则假定为16。未来可能会更大。

The result may contain A-Z, a-z, 0-9, “+”, “/” and “=”.

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

如果安全随机数发生器不可用，NotImplementedError则引发。

有关base64的定义，请参阅RFC 3548。

# File lib/securerandom.rb, line 139
def base64(n=nil)
  [random_bytes(n)].pack("m0")
end

hex(n=nil) Show source

SecureRandom.hex生成一个随机的十六进制字符串。

参数n指定要生成的随机数的长度（以字节为单位）。得到的十六进制字符串的长度是n的两倍。

如果n未被指定或者为零，则假定为16。未来可能会更大。

结果可能包含0-9和af。

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

如果安全随机数发生器不可用，NotImplementedError则引发。

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

rand(*args) Show source

static VALUE
rand_random_number(int argc, VALUE *argv, VALUE obj)
{
    rb_random_t *rnd = try_get_rnd(obj
    VALUE v = rand_random(argc, argv, obj, rnd
    if (NIL_P(v)) v = rand_random(0, 0, obj, rnd
    else if (!v) invalid_argument(argv[0]
    return v;
}

random_bytes(n=nil) Show source

SecureRandom.random_bytes生成一个随机二进制字符串。

参数n指定结果字符串的长度。

如果n未被指定或者为零，则假定为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 98
def random_bytes(n=nil)
  n = n ? n.to_int : 16
  gen_random(n)
end

random_number(*args) Show source

static VALUE
rand_random_number(int argc, VALUE *argv, VALUE obj)
{
    rb_random_t *rnd = try_get_rnd(obj
    VALUE v = rand_random(argc, argv, obj, rnd
    if (NIL_P(v)) v = rand_random(0, 0, obj, rnd
    else if (!v) invalid_argument(argv[0]
    return v;
}

urlsafe_base64(n=nil, padding=false) Show source

SecureRandom.urlsafe_base64生成一个随机的URL安全base64字符串。

参数n指定要生成的随机数的长度（以字节为单位）。结果字符串的长度约为n的 4/3 。

如果n未被指定或者为零，则假定为16。未来可能会更大。

布尔参数padding指定填充。如果它是假或零，则不会生成填充。否则会产生填充。默认情况下，不会生成填充，因为“=”可能会用作URL分隔符。

结果可能包含AZ，az，0-9，“ - ”和“_”。如果填充为真，则也使用“=” 。

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则引发。

有关URL安全base64的定义，请参阅RFC 3548。

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

uuid() Show source

# 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 generates a random v4 UUID (Universally Unique IDentifier). # # p SecureRandom.uuid #=> “2d931510-d99f-494a-8c67-87feb05e1594” # p SecureRandom.uuid #=> “bad85eb9-0713-4da7-8d36-07a8e4b00eab” # p SecureRandom.uuid #=> “62936e70-1815-439b-bf89-8492855a7e6b” # # The version 4 UUID is purely random (except the version). # It doesn't contain meaningful information such as MAC addresses, timestamps, etc. # # The result contains 122 random bits (15.25 random bytes). # # See RFC 4122 for details of UUID.

# File lib/securerandom.rb, line 236
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

私有实例方法

gen_random(n) Show source

# File lib/securerandom.rb, line 244
def gen_random(n)
  self.bytes(n)
end