RandomBytes v1.0.4 RandomBytes View Source

Generate random strings in a few different formats.

Link to this section Summary

Functions

base16(num_bytes \\ 16)

Generates a random base16 string

base62(num_bytes \\ 16)

Generates a random base62 string

uuid()

Generates a UUID (universally unique identifier)

Link to this section Functions

base16(num_bytes \\ 16)

Generates a random base16 string.

The result string can contain the following characters: 0-9, a-f.

The length of the result string is twice num_bytes.

Examples

iex> RandomBytes.base16
"442141c62390aa41c7c2561df1ba7c68"
iex> RandomBytes.base16(3)
"dc4bca"

base62(num_bytes \\ 16)

Generates a random base62 string.

A base64 string typically contains the + and / characters as its extra 2 characters. When the string will be used in a url, the + and / are usually replaced with - and _.

This function generates a base62 string, not a base64 string. It returns only letters and numbers and doesn’t include the two special characters. The result string can contain the following characters: A-Z, a-z, 0-9.

The length of the result string is about 4/3 of num_bytes.

Examples

iex> RandomBytes.base62
"zx1QBjpTMPuHKBHpQBv9IQ"
iex> RandomBytes.base62(30)
"io0i0jE70S2PmvBvnnE6272JbpBaoLbmxJmJXJUL"
iex> RandomBytes.base62(10)
"8BfF7DS2nxsPyg"

uuid()

Generates a UUID (universally unique identifier).

This is a v4 UUID defined by RFC 4122.

Examples

iex> RandomBytes.uuid
"5b1e4da9-bdf4-46d6-a741-21d2d1827e13"
iex> RandomBytes.uuid
"153282b3-0e2d-4e10-8839-cb0ee869e898"