uint8Slices.go

// Code generated by yasupGen; DO NOT EDIT.

package yasup

import (
	crypto "crypto/rand"
	"math/big"
	"math/rand"
)

var zeroValueUint8 uint8

//Uint8Insert will append elem at the position i. Might return ErrIndexOutOfBounds.
func Uint8Insert(sl *[]uint8, elem uint8, i int) error {
	if i < 0 || i > len(*sl) {
		return ErrIndexOutOfBounds
	}
	*sl = append(*sl, elem)
	copy((*sl)[i+1:], (*sl)[i:])
	(*sl)[i] = elem
	return nil
}

//Uint8Delete delete the element at the position i. Might return ErrIndexOutOfBounds.
func Uint8Delete(sl *[]uint8, i int) error {
	if i < 0 || i >= len(*sl) {
		return ErrIndexOutOfBounds
	}
	*sl = append((*sl)[:i], (*sl)[i+1:]...)
	return nil
}

//Uint8Contains will return true if elem is present in the slice and false otherwise.
func Uint8Contains(sl []uint8, elem uint8) bool {
	for i := range sl {
		if sl[i] == elem {
			return true
		}
	}
	return false
}

//Uint8Index returns the index of the first instance of elem, or -1 if elem is not present.
func Uint8Index(sl []uint8, elem uint8) int {
	for i := range sl {
		if sl[i] == elem {
			return i
		}
	}
	return -1
}

//Uint8LastIndex returns the index of the last instance of elem in the slice, or -1 if elem is not present.
func Uint8LastIndex(sl []uint8, elem uint8) int {
	for i := len(sl) - 1; i >= 0; i-- {
		if sl[i] == elem {
			return i
		}
	}
	return -1
}

//Uint8Count will return an int representing the amount of times that elem is present in the slice.
func Uint8Count(sl []uint8, elem uint8) int {
	var n int
	for i := range sl {
		if sl[i] == elem {
			n++
		}
	}
	return n
}

//Uint8Push is equivalent to Uint8Insert with index len(*sl).
func Uint8Push(sl *[]uint8, elem uint8) {
	Uint8Insert(sl, elem, len(*sl))
}

//Uint8FrontPush is equivalent to Uint8Insert with index 0.
func Uint8FrontPush(sl *[]uint8, elem uint8) {
	Uint8Insert(sl, elem, 0)
}

//Uint8Pop is equivalent to getting and removing the last element of the slice. Might return ErrEmptySlice.
func Uint8Pop(sl *[]uint8) (uint8, error) {
	if len(*sl) == 0 {
		return zeroValueUint8, ErrEmptySlice
	}
	last := len(*sl) - 1
	ret := (*sl)[last]
	Uint8Delete(sl, last)
	return ret, nil
}

//Uint8Pop is equivalent to getting and removing the first element of the slice. Might return ErrEmptySlice.
func Uint8FrontPop(sl *[]uint8) (uint8, error) {
	if len(*sl) == 0 {
		return zeroValueUint8, ErrEmptySlice
	}
	ret := (*sl)[0]
	Uint8Delete(sl, 0)
	return ret, nil
}

//Uint8Replace modifies the slice with the first n non-overlapping instances of old replaced by new. If n equals -1, there is no limit on the number of replacements.
func Uint8Replace(sl []uint8, old, new uint8, n int) (replacements int) {
	left := n
	for i := range sl {
		if left == 0 {
			break // no replacements left
		}
		if sl[i] == old {
			sl[i] = new
			left--
		}
	}
	return n - left
}

//Uint8ReplaceAll is equivalent to Uint8Replace with n = -1.
func Uint8ReplaceAll(sl []uint8, old, new uint8) (replacements int) {
	return Uint8Replace(sl, old, new, -1)
}

//Uint8Equals compares two uint8 slices. Returns true if their elements are equal.
func Uint8Equals(a, b []uint8) bool {
	if len(a) != len(b) {
		return false
	}
	for i := range a {
		if a[i] != b[i] {
			return false
		}
	}
	return true
}

//Uint8FastShuffle will randomly swap the uint8 elements of a slice using math/rand (fast but not cryptographycally secure).
func Uint8FastShuffle(sp []uint8) {
	rand.Shuffle(len(sp), func(i, j int) {
		sp[i], sp[j] = sp[j], sp[i]
	})
}

//Uint8SecureShuffle will randomly swap the uint8 elements of a slice using crypto/rand (resource intensive but cryptographically secure).
func Uint8SecureShuffle(sp []uint8) error {
	var i int64
	size := int64(len(sp)) - 1
	for i = 0; i < size+1; i++ {
		bigRandI, err := crypto.Int(crypto.Reader, big.NewInt(size))
		if err != nil {
			return err
		}
		randI := bigRandI.Int64()
		sp[size-i], sp[randI] = sp[randI], sp[size-i]
	}
	return nil
}