End of Life Ruby 3.0 has reached end of life and gets no more fixes. Switch to Ruby 4.0 →

instance method

Random::Formatter#urlsafe_base64

urlsafe_base64(n=nil, padding=false)

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

SecureRandom.urlsafe_base64 generates a random URL-safe base64 string.

The argument n specifies the length, in bytes, of the random number to be generated. The length of the result string is about 4/3 of n.

If n is not specified or is nil, 16 is assumed. It may be larger in the future.

The boolean argument padding specifies the padding. If it is false or nil, padding is not generated. Otherwise padding is generated. By default, padding is not generated because “=” may be used as a URL delimiter.

The result may contain A-Z, a-z, 0-9, “-” and “_”. “=” is also used if padding is true.

Example

require 'securerandom'

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

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

If a secure random number generator is not available, NotImplementedError is raised.

See RFC 3548 for the definition of URL-safe base64.

See also #random_number #uuid #random_bytes also in 4.1 · 4.0 · 3.4 · 3.3 · 3.2 · 3.1

‹ prev#random_number next ›#uuid