random

Documentation

Index

• type CryptoSeed
  • func (c CryptoSeed) Int63() int64
  • func (c CryptoSeed) Seed(seed int64)
  • func (c CryptoSeed) Uint64() uint64
• type Random
  • func New(s rand.Source) *Random
  • func (r *Random) Bool() bool
  • func (r *Random) ElementFromSlice(slice interface{}) interface{}
  • func (r *Random) Float32() float32
  • func (r *Random) Float64() float64
  • func (r *Random) Int() int
  • func (r *Random) IntBetween(min, max int) int
  • func (r *Random) IntN(n int) int
  • func (r *Random) KeyFromMap(anyMap interface{}) interface{}
  • func (r *Random) String() string
  • func (r *Random) StringN(length int) string
  • func (r *Random) StringNWithCharset(length int, charset string) string
  • func (r *Random) Time() time.Time
  • func (r *Random) TimeBetween(from, to time.Time) time.Time

Examples

• Random (CryptoSeed)
• Random (MathRand)
• Random.Bool
• Random.ElementFromSlice
• Random.Float32
• Random.Float64
• Random.Int
• Random.IntBetween
• Random.IntN
• Random.KeyFromMap
• Random.String
• Random.StringN
• Random.Time
• Random.TimeBetween

Types

type CryptoSeed

type CryptoSeed struct{}

func (CryptoSeed) Int63

func (c CryptoSeed) Int63() int64

Int63 returns a non-negative pseudo-random 63-bit integer as an int64.

func (CryptoSeed) Seed

func (c CryptoSeed) Seed(seed int64)

Seed should use the provided seed value to initialize the generator to a deterministic state, but in CryptoSeed, the value is ignored.

func (CryptoSeed) Uint64

func (c CryptoSeed) Uint64() uint64

type Random

type Random struct {
	Source rand.Source
	// contains filtered or unexported fields
}

A Random is a source of random numbers. It is safe to be used in from multiple goroutines.

Example (CryptoSeed)

package main

import (
	"github.com/adamluzsi/testcase/random"
)

func main() {
	random.New(random.CryptoSeed{})
}

Example (MathRand)

package main

import (
	"math/rand"
	"time"

	"github.com/adamluzsi/testcase/random"
)

func main() {
	seed := time.Now().UnixNano()
	source := rand.NewSource(seed)
	random.New(source)
}

func New

func New(s rand.Source) *Random

func (*Random) Bool

func (r *Random) Bool() bool

Example

package main

import (
	"math/rand"
	"time"

	"github.com/adamluzsi/testcase/random"
)

func main() {
	rnd := random.New(rand.NewSource(time.Now().Unix()))

	_ = rnd.Bool() // returns a random bool
}

func (*Random) ElementFromSlice

func (r *Random) ElementFromSlice(slice interface{}) interface{}

Example

package main

import (
	"math/rand"
	"time"

	"github.com/adamluzsi/testcase/random"
)

func main() {
	rnd := random.New(rand.NewSource(time.Now().Unix()))

	// returns a random element from the given slice
	_ = rnd.ElementFromSlice([]string{`foo`, `bar`, `baz`}).(string)
}

func (*Random) Float32

func (r *Random) Float32() float32

Float32 returns, as a float32, a pseudo-random number in [0.0,1.0).

Example

package main

import (
	"math/rand"
	"time"

	"github.com/adamluzsi/testcase/random"
)

func main() {
	rnd := random.New(rand.NewSource(time.Now().Unix()))

	_ = rnd.Float32()
}

func (*Random) Float64

func (r *Random) Float64() float64

Float64 returns, as a float64, a pseudo-random number in [0.0,1.0).

Example

package main

import (
	"math/rand"
	"time"

	"github.com/adamluzsi/testcase/random"
)

func main() {
	rnd := random.New(rand.NewSource(time.Now().Unix()))

	_ = rnd.Float64()
}

func (*Random) Int

func (r *Random) Int() int

Int returns a non-negative pseudo-random int.

Example

package main

import (
	"math/rand"
	"time"

	"github.com/adamluzsi/testcase/random"
)

func main() {
	rnd := random.New(rand.NewSource(time.Now().Unix()))

	_ = rnd.Int()
}

func (*Random) IntBetween

func (r *Random) IntBetween(min, max int) int

IntBetween returns, as an int, a non-negative pseudo-random number based on the received int range's [min,max].

Example

package main

import (
	"math/rand"
	"time"

	"github.com/adamluzsi/testcase/random"
)

func main() {
	rnd := random.New(rand.NewSource(time.Now().Unix()))

	_ = rnd.IntBetween(24, 42)
}

func (*Random) IntN

func (r *Random) IntN(n int) int

IntN returns, as an int, a non-negative pseudo-random number in [0,n). It panics if n <= 0.

Example

package main

import (
	"math/rand"
	"time"

	"github.com/adamluzsi/testcase/random"
)

func main() {
	rnd := random.New(rand.NewSource(time.Now().Unix()))

	_ = rnd.IntN(42)
}

func (*Random) KeyFromMap

func (r *Random) KeyFromMap(anyMap interface{}) interface{}

Example

package main

import (
	"math/rand"
	"time"

	"github.com/adamluzsi/testcase/random"
)

func main() {
	rnd := random.New(rand.NewSource(time.Now().Unix()))

	_ = rnd.KeyFromMap(map[string]struct{}{
		`foo`: {},
		`bar`: {},
		`baz`: {},
	}).(string)
}

func (*Random) String

func (r *Random) String() string

Example

package main

import (
	"math/rand"
	"time"

	"github.com/adamluzsi/testcase/random"
)

func main() {
	rnd := random.New(rand.NewSource(time.Now().Unix()))

	_ = rnd.String()
}

func (*Random) StringN

func (r *Random) StringN(length int) string

Example

package main

import (
	"math/rand"
	"time"

	"github.com/adamluzsi/testcase/random"
)

func main() {
	rnd := random.New(rand.NewSource(time.Now().Unix()))

	_ = rnd.StringN(42)
}

func (*Random) StringNWithCharset

func (r *Random) StringNWithCharset(length int, charset string) string

func (*Random) Time

func (r *Random) Time() time.Time

Example

package main

import (
	"math/rand"
	"time"

	"github.com/adamluzsi/testcase/random"
)

func main() {
	rnd := random.New(rand.NewSource(time.Now().Unix()))

	_ = rnd.Time()
}

func (*Random) TimeBetween

func (r *Random) TimeBetween(from, to time.Time) time.Time

TimeBetween returns, as an time.Time, a non-negative pseudo-random time in [from,to].

Example

package main

import (
	"math/rand"
	"time"

	"github.com/adamluzsi/testcase/random"
)

func main() {
	rnd := random.New(rand.NewSource(time.Now().Unix()))

	_ = rnd.TimeBetween(time.Now(), time.Now().Add(time.Hour))
}