niki/vendor/github.com/brianvoe/gofakeit/v7/source/sfc.go

45 lines
1.5 KiB
Go

package source
// The SFC(Simple Fast Counter) algorithm is designed for fast and efficient generation of pseudo-random numbers,
// utilizing arithmetic and bitwise operations across state variables and a counter to ensure
// good randomness quality. It is particularly well-suited for applications requiring rapid
// number generation without the need for cryptographic security.
// Pros:
// - High efficiency and speed, ideal for performance-sensitive applications.
// - Simple to implement and maintain, with minimal computational overhead.
// - Offers a balance between speed and randomness quality, suitable for a wide range of uses.
// Cons:
// - Not designed for cryptographic applications due to its level of randomness.
// - Initial seeding mechanism is basic; may require enhancement for more complex use cases.
type SFC struct {
a, b, c, counter uint64
}
// NewSFC creates and returns a new SFC pseudo-random number generator seeded with a given seed.
func NewSFC(seed uint64) *SFC {
s := &SFC{}
s.Seed(seed)
return s
}
// Seed sets the seed of the SFC. This implementation can be enhanced to
// provide a more distributed seeding process across the state variables.
func (s *SFC) Seed(seed uint64) {
s.a = seed
s.b = seed
s.c = seed
s.counter = 1 // Reset counter with new seed
}
// Uint64 generates a pseudo-random 64-bit value using the SFC algorithm.
func (s *SFC) Uint64() uint64 {
s.a += s.b + s.counter
s.b ^= s.c
s.c -= s.a
s.counter++
return s.c + s.b
}