randutil

Documentation

Overview

Package randutil provides methods to generate random strings and salts.

Index

• func ASCII(length int) (string, error)
• func Alphabet(length int) (string, error)
• func Alphanumeric(length int) (string, error)
• func Bytes(size int) ([]byte, error)
• func Hex(length int) (string, error)
• func Salt(size int) ([]byte, error)
• func String(length int, chars string) (string, error)
• func UUIDv4() (string, error)

Functions

func ASCII

func ASCII(length int) (string, error)

ASCII returns a securely generated random ASCII string. It reads random numbers from crypto/rand and searches for printable characters. It will return an error if the system's secure random number generator fails to function correctly, in which case the caller must not continue.

func Alphabet

func Alphabet(length int) (string, error)

Alphabet returns a random string of the given length using the 52 alphabetic characters in the POSIX/C locale (a-z+A-Z).

func Alphanumeric

func Alphanumeric(length int) (string, error)

Alphanumeric returns a random string of the given length using the 62 alphanumeric characters in the POSIX/C locale (a-z+A-Z+0-9).

func Bytes

func Bytes(size int) ([]byte, error)

Bytes generates a new byte slice of the given size.

func Hex

func Hex(length int) (string, error)

Hex returns a random string of the given length using the hexadecimal characters in lower case (0-9+a-f).

func Salt

func Salt(size int) ([]byte, error)

Salt generates a new random salt of the given size.

func String

func String(length int, chars string) (string, error)

String returns a random string of a given length using the characters in the given string. It splits the string on runes to support UTF-8 characters.

func UUIDv4

func UUIDv4() (string, error)

UUIDv4 returns the string representation of a UUID version 4. Because 6 bits are used to indicate the version 4 and the variant 10, the randomly generated part has 122 bits.