module Random::Formatter

要約

生成した乱数を 16 進文字列や base64 文字列、UUID など、人が扱いやすい形式の文字列に整形するためのメソッド群を提供するモジュールです。

このモジュールは Random に include され、SecureRandom には extend されています。ただし、以下の整形用メソッドが定義されるのは require "random/formatter" を読み込んだとき(require "securerandom" でも読み込まれます)です。読み込むと、Random のインスタンスと SecureRandom の両方でこれらのメソッドが使えるようになります。

• random_bytes
• hex
• base64
• urlsafe_base64
• alphanumeric
• uuid など

これらのメソッドの詳しい説明は SecureRandom を参照してください。

目次

インスタンスメソッド

• alphanumeric

インスタンスメソッド

alphanumeric(n = nil, chars: ALPHANUMERIC) -> StringRuby 3.0 から[permalink][rdoc][edit]

ランダムな英数字を生成して返します。

Random のインスタンスメソッド、および Random と SecureRandom の特異メソッドとして使用できます。

[PARAM] n:

生成される文字列のサイズを整数で指定します。 nil を指定した場合 n として 16 が使われます。

[PARAM] chars:

生成に使う文字の配列を指定します。省略した場合は A-Z, a-z, 0-9 が使われます。

[RETURN]

A-Z, a-z, 0-9 からなる文字列が返されます。 (chars を指定した場合は、chars に含まれる文字からなる文字列が返されます)

require 'random/formatter'

prng = Random.new
p prng.alphanumeric(10) # => "S8baxMJnPl"
p Random.alphanumeric   # => "TmP9OsJHJLtaZYhP"

p prng.alphanumeric(10, chars: [*"!".."/"]) # => ",.,++%/''."

[SEE_ALSO] SecureRandom.alphanumeric