Method String

random/random.go:45–87

(length uint8, charsets ...string)

}

func (r *Random) String(length uint8, charsets ...string) string {
	charset := strings.Join(charsets, "")
	if charset == "" {
		charset = Alphanumeric
	}

	charsetLen := len(charset)
	if charsetLen > 255 {
		charsetLen = 255
	}
	maxByte := 255 - (256 % charsetLen)

	reader := r.readerPool.Get().(*bufio.Reader)
	defer r.readerPool.Put(reader)

	b := make([]byte, length)
	rs := make([]byte, length+(length/4)) // perf: avoid read from rand.Reader many times
	var i uint8 = 0

	// security note:
	// we can't just simply do b[i]=charset[rb%byte(charsetLen)],
	// for example, when charsetLen is 52, and rb is [0, 255], 256 = 52 * 4 + 48.
	// this will make the first 48 characters more possibly to be generated then others.
	// so we have to skip bytes when rb > maxByte

	for {
		_, err := io.ReadFull(reader, rs)
		if err != nil {
			panic("unexpected error happened when reading from bufio.NewReader(crypto/rand.Reader)")
		}
		for _, rb := range rs {
			if rb > byte(maxByte) {
				// Skip this number to avoid bias.
				continue
			}
			b[i] = charset[rb%byte(charsetLen)]
			i++
			if i == length {
				return string(b)
			}
		}
	}
}

func String(length uint8, charsets ...string) string {
	return global.String(length, charsets...)