package rand

Import Path
	crypto/rand (on

Dependency Relation
	imports 12 packages, and imported by 5 packages

Involved Source Files Package rand implements a cryptographically secure random number generator. rand_getrandom.go rand_unix.go util.go
Code Examples package main import ( "bytes" "crypto/rand" "fmt" ) func main() { 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))) }
Package-Level Functions (total 3)
Int returns a uniform random value in [0, max). It panics if max <= 0.
Prime returns a number of the given bit length that 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.
Package-Level Variables (only one)
Reader is a global, shared instance of a cryptographically secure random number generator. On Linux, FreeBSD, Dragonfly, NetBSD and Solaris, Reader uses getrandom(2) if available, /dev/urandom otherwise. On OpenBSD and macOS, Reader uses getentropy(2). On other Unix-like systems, Reader reads from /dev/urandom. On Windows systems, Reader uses the ProcessPrng API. On JS/Wasm, Reader uses the Web Crypto API. On WASIP1/Wasm, Reader uses random_get from wasi_snapshot_preview1.