Documentation
¶
Overview ¶
Package rand implements a cryptographically secure random number generator.
Index ¶
Examples ¶
Constants ¶
This section is empty.
Variables ¶
View Source
var Reader io.Reader
Reader is a global, shared instance of a cryptographically secure random number generator.
- On Linux, FreeBSD, Dragonfly, and Solaris, Reader uses getrandom(2) if available, and /dev/urandom otherwise.
- On macOS and iOS, Reader uses arc4random_buf(3).
- On OpenBSD and NetBSD, Reader uses getentropy(2).
- On other Unix-like systems, Reader reads from /dev/urandom.
- On Windows, 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.
Functions ¶
func Prime ¶
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.
func Read ¶
Read is a helper function that calls Reader.Read using io.ReadFull. On return, n == len(b) if and only if err == nil.
Example ¶
This example reads 10 cryptographically secure pseudorandom numbers from rand.Reader and writes them to a byte slice.
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)))
}
Output: false
Types ¶
This section is empty.
Source Files
Click to show internal directories.
Click to hide internal directories.