import "crypto/rand"
Package rand implements a cryptographically secure random number generator.
eagain.go rand.go rand_batched.go rand_linux.go rand_unix.go util.go
Reader is a global, shared instance of a cryptographically secure random number generator.
On Linux and FreeBSD, Reader uses getrandom(2) if available, /dev/urandom otherwise. On OpenBSD, Reader uses getentropy(2). On other Unix-like systems, Reader reads from /dev/urandom. On Windows systems, Reader uses the CryptGenRandom API. On Wasm, Reader uses the Web Crypto API.
Int returns a uniform random value in [0, max). It panics if max <= 0.
Prime returns a number, p, of the given size, such that p is prime with high probability. Prime will return error for any error returned by rand.Read or if bits < 2.
Read is a helper function that calls Reader.Read using io.ReadFull. On return, n == len(b) if and only if err == nil.
This example reads 10 cryptographically secure pseudorandom numbers from rand.Reader and writes them to a byte slice.
Code:play
c := 10
b := make([]byte, c)
_, err := rand.Read(b)
if err != nil {
fmt.Println("error:", err)
return
}
// The slice should now contain random bytes instead of only zeroes.
fmt.Println(bytes.Equal(b, make([]byte, c)))
Output:
false
Package rand imports 14 packages (graph) and is imported by 42873 packages. Updated 2021-01-21. Refresh now. Tools for package owners.