random

Documentation

Overview

Package random exposes random values to Meow programs.

Roll, Drift and Pick draw from math/rand/v2, which is fine for sampling and jitter. Tuft draws from crypto/rand instead, because it exists to label things — a marker that collides, or that an observer can predict, defeats the purpose of having one.

Index

• func Drift(args ...meowrt.Value) meowrt.Value
• func Pick(args ...meowrt.Value) meowrt.Value
• func Roll(args ...meowrt.Value) meowrt.Value
• func Tuft(args ...meowrt.Value) meowrt.Value

Functions

func Drift

func Drift(args ...meowrt.Value) meowrt.Value

Drift returns a random float in [0, 1).

func Pick

func Pick(args ...meowrt.Value) meowrt.Value

Pick returns a random element of a litter.

func Roll

func Roll(args ...meowrt.Value) meowrt.Value

Roll returns a random integer in [0, n).

func Tuft

func Tuft(args ...meowrt.Value) meowrt.Value

Tuft returns n random bytes as a lowercase hex string, so the result is 2n characters long. It is drawn from a cryptographic source, which makes it suitable for the markers and correlation IDs it is meant for.