Random provides an interface for random values generation, using a pseudo random number generator (PRNG).
Random.rand # => 0.167595 Random.rand(5) # => 2
The above methods delegate to a Random instance.
r = Random.new r.rand # => 0.0372991 r.next_bool # => true r.next_int # => 2223112
This module also defines a global method #rand, which Array#sample and Array#shuffle delegates.
rand # => 0.293829 rand(10) # => 8
An instance of each class that includes Random is a random number generator with its own state. Usually such RNGs can be initialized with a seed, which defines their initial state. It is guaranteed that after initializing two different instances with the same seed, and then executing the same calls on both of them, you will get the same results. This allows exactly reproducing the same seemingly random events by just keeping the seed.
It is possible to make a custom RNG by including Random and implementing #next_u to return an unsigned number of a pre-determined type (usually UInt32). The numbers generated by your RNG must be uniformly distributed in the whole range of possible values for that type (e.g. 0u32..UInt32::MAX). This allows all other methods of Random to be based on this and still produce uniformly distributed results. Your Random class should also have a way to initialize it. For pseudo-random number generators that will usually be an integer seed, but there are no rigid requirements for the initialization.
The default PRNG is Random::PCG32 which has a good overall statistical distribution (low bias of generated numbers) and is fast for overall usages on different platforms, but isn't cryptographically secure. If a third party has access to some generated numbers, she may deduce incoming numbers, putting your application at risk.
It is recommended to use a secure source, such as Random::Secure, Random::ISAAC or ChaCha20 for anything that needs security, such as online games, identification tokens, salts, initializing a PRNG, ... These PRNG are slower but cryptographically secure, so a third party can't deduce incoming numbers.
PCG32.new DEPRECATED Use #rand, Random.next_int or Random::Secure.random_bytes for example, or create a local instance with Random.new instead.
Initializes an instance with the given seed and sequence.
Initializes an instance seeded from a system source.
See #split.
See #next_bool.
See #next_int.
See #rand(x).
See #rand.
Generates n random bytes that are encoded into base64.
Generates a hexadecimal string based on n random bytes.
Reseed the generator.
Generates a random Bool.
See #rand.
Same as #rand(Int32::MIN..Int32::MAX).
Generates a random unsigned integer.
Generates a random integer which is greater than or equal to 0 and less than max.
Returns a random Float which is greater than or equal to 0 and less than max.
Returns a random Float which is greater than or equal to 0 and less than max.
Returns a random integer in the given range.
Returns a random Float in the given range.
Returns a StaticArray filled with random Int8 values.
Returns a StaticArray filled with random UInt8 values.
Returns a StaticArray filled with random Int16 values.
Returns a StaticArray filled with random UInt16 values.
Returns a StaticArray filled with random Int32 values.
Returns a StaticArray filled with random UInt32 values.
Returns a StaticArray filled with random Int64 values.
Returns a StaticArray filled with random UInt64 values.
Returns a StaticArray filled with random Int128 values.
Returns a StaticArray filled with random UInt128 values.
Returns a random Int8
Returns a random UInt8
Returns a random Int16
Returns a random UInt16
Returns a random Int32
Returns a random UInt32
Returns a random Int64
Returns a random UInt64
Returns a random Int128
Returns a random UInt128
Generates a random Float64 between 0 and 1.
Generates a slice filled with n random bytes.
Fills a given slice with random bytes.
Splits the current instance into two seemingly independent instances that will return distinct sequences of random numbers.
The internal implementation for #split where self is the original instance and other the duplicated instance to be returned.
Generates n random bytes that are encoded as a URL-safe base64 string.
Initializes an instance with the given seed and sequence.
Initializes an instance seeded from a system source.
See #next_bool.
Generates n random bytes that are encoded into base64.
The parameter 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 due to the base64 encoding. The result receives a padding consisting of = characters to fill up the string size to a multiple of 4.
Check Base64#strict_encode for details.
Random::Secure.base64(4) # => "fK1eYg=="
It is recommended to use the secure Random::Secure as a source or another cryptographically quality PRNG such as Random::ISAAC or ChaCha20.
Generates a hexadecimal string based on n random bytes.
The bytes are encoded into a string of two-digit hexadecimal number (00-ff) per byte.
Random::Secure.hex # => "05f100a1123f6bdbb427698ab664ff5f" Random::Secure.hex(1) # => "1a"
It is recommended to use the secure Random::Secure as a source or another cryptographically quality PRNG such as Random::ISAAC or ChaCha20.
Reseed the generator.
Same as #rand(Int32::MIN..Int32::MAX).
Generates a random unsigned integer.
The integers must be uniformly distributed between 0 and the maximal value for the chosen type.
Generates a random integer which is greater than or equal to 0 and less than max.
The return type always matches the supplied argument.
Random.new.rand(10) # => 5 Random.new.rand(5000) # => 2243
Returns a random Float which is greater than or equal to 0 and less than max.
Random.new.rand(3.5) # => 2.88938 Random.new.rand(10.725) # => 7.70147
Returns a random Float which is greater than or equal to 0 and less than max.
Random.new.rand(3.5) # => 2.88938 Random.new.rand(10.725) # => 7.70147
Returns a random integer in the given range.
The return type always matches the supplied argument.
Random.new.rand(10..20) # => 14 Random.new.rand(Int64::MIN..Int64::MAX) # => -5297435808626736140
Returns a random Float in the given range.
Random.new.rand(6.2..21.768) # => 15.2989
Returns a StaticArray filled with random Int8 values.
rand(StaticArray(Int8, 4)) # => StaticArray[20, -66, 89, 19]
Returns a StaticArray filled with random UInt8 values.
rand(StaticArray(UInt8, 4)) # => StaticArray[186, 221, 127, 245]
Returns a StaticArray filled with random Int16 values.
rand(StaticArray(Int16, 4)) # => StaticArray[-32554, 32169, -20152, -7686]
Returns a StaticArray filled with random UInt16 values.
rand(StaticArray(UInt16, 4)) # => StaticArray[39546, 44091, 2874, 17348]
Returns a StaticArray filled with random Int32 values.
rand(StaticArray(Int32, 4)) # => StaticArray[1870830079, -1043532158, -867180637, -1216773590]
Returns a StaticArray filled with random UInt32 values.
rand(StaticArray(UInt32, 4)) # => StaticArray[3147957137, 4245108745, 2207809043, 3184391838]
Returns a StaticArray filled with random Int64 values.
rand(StaticArray(Int64, 4)) # => StaticArray[4438449217673515190, 8514493061600538358, -4874671083204037318, -7825896160729246667]
Returns a StaticArray filled with random UInt64 values.
rand(StaticArray(UInt64, 4)) # => StaticArray[15004487597684511003, 12027825265648206103, 11303949506191212698, 6228566501671148658]
Returns a StaticArray filled with random Int128 values.
rand(StaticArray(Int128, 4)) # => StaticArray[-33248638598154624979861619415313153263, 7715345987200799268985566794637461715, 51883986405785085023723116953594906714, -63505201678563022521901409748929046368]
Returns a StaticArray filled with random UInt128 values.
rand(StaticArray(UInt128, 4)) # => StaticArray[209016375821699277802308597707088869733, 168739091726124084850659068882871627438, 293712757766410232411790495845165436283, 15480005665598870938163293877660434201]
Returns a random Int64
rand(Int64) # => 4438449217673515190
Returns a random UInt64
rand(UInt64) # => 15004487597684511003
Returns a random Int128
rand(Int128) # => -33248638598154624979861619415313153263
Returns a random UInt128
rand(UInt128) # => 209016375821699277802308597707088869733
Generates a random Float64 between 0 and 1.
r = Random.new r.rand # => 0.167595 r.rand # => 0.0372991
Generates a slice filled with n random bytes.
Random.new.random_bytes # => [145, 255, 191, 133, 132, 139, 53, 136, 93, 238, 2, 37, 138, 244, 3, 216] Random.new.random_bytes(4) # => [217, 118, 38, 196]
Fills a given slice with random bytes.
slice = Bytes.new(4) # => [0, 0, 0, 0] Random.new.random_bytes(slice) slice # => [217, 118, 38, 196]
Splits the current instance into two seemingly independent instances that will return distinct sequences of random numbers. Returns a new instance.
random = Random.new
split1 = random.split
split2 = random.split
Array.new(5) { random.rand(99) } # => [79, 42, 54, 17, 52]
Array.new(5) { split1.rand(99) } # => [90, 37, 15, 74, 61]
Array.new(5) { split2.rand(99) } # => [6, 87, 5, 73, 71] The internal implementation for #split where self is the original instance and other the duplicated instance to be returned.
The default Random implementation in stdlib is splittable, but not every PRNG algorithm is splittable, so the method raises a NotImplementedError exception by default.
Generates n random bytes that are encoded as a URL-safe base64 string.
The parameter 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 due to the base64 encoding. If padding is true, the result receives a padding consisting of = characters to fill up the string size to a multiple of 4.
Check Base64#urlsafe_encode for details.
Random::Secure.urlsafe_base64 # => "MAD2bw8QaBdvITCveBNCrw" Random::Secure.urlsafe_base64(8, padding: true) # => "vvP1kcs841I=" Random::Secure.urlsafe_base64(16, padding: true) # => "og2aJrELDZWSdJfVGkxNKw=="
It is recommended to use the secure Random::Secure as a source or another cryptographically quality PRNG such as Random::ISAAC or ChaCha20.
© 2012–2026 Manas Technology Solutions.
Licensed under the Apache License, Version 2.0.
https://crystal-lang.org/api/1.19.0/Random.html