random functions
Functions for generating random values.
About randomness
gomplate uses Go’s math/rand package
to generate pseudo-random numbers. Note that these functions are not suitable
for use in security-sensitive applications, such as cryptography. However,
these functions will not deplete system entropy.
random.ASCII
Generates a random string of a desired length, containing the set of printable characters from the 7-bit ASCII set. This includes space (’ ‘), but no other whitespace characters.
Added in gomplate v3.4.0
Usage
Arguments
| name | description |
|---|---|
count |
(required) the length of the string to produce (number of characters) |
Examples
random.Alpha
Generates a random alphabetical (A-Z, a-z) string of a desired length.
Added in gomplate v3.4.0
Usage
Arguments
| name | description |
|---|---|
count |
(required) the length of the string to produce (number of characters) |
Examples
random.AlphaNum
Generates a random alphanumeric (0-9, A-Z, a-z) string of a desired length.
Added in gomplate v3.4.0
Usage
Arguments
| name | description |
|---|---|
count |
(required) the length of the string to produce (number of characters) |
Examples
random.String
Generates a random string of a desired length.
By default, the possible characters are those represented by the
regular expression [a-zA-Z0-9_.-] (alphanumeric, plus _, ., and -).
A different set of characters can be specified with a regular expression,
or by giving a range of possible characters by specifying the lower and
upper bounds. Lower/upper bounds can be specified as characters (e.g.
"q", or escape sequences such as "\U0001f0AF"), or numeric Unicode
code-points (e.g. 48 or 0x30 for the character 0).
When given a range of Unicode code-points, random.String will discard
non-printable characters from the selection. This may result in a much
smaller set of possible characters than intended, so check
the Unicode character code charts to
verify the correct code-points.
Added in gomplate v3.4.0
Usage
Arguments
| name | description |
|---|---|
count |
(required) the length of the string to produce (number of characters) |
regex |
(optional) the regular expression that each character must match (defaults to [a-zA-Z0-9_.-]) |
lower |
(optional) lower bound for a range of characters (number or single character) |
upper |
(optional) upper bound for a range of characters (number or single character) |
Examples
random.Item
Pick an element at a random from a given slice or array.
Added in gomplate v3.4.0
Usage
Arguments
| name | description |
|---|---|
items |
(required) the input array |
Examples
random.Number
Pick a random integer. By default, a number between 0 and 100
(inclusive) is chosen, but this range can be overridden.
Note that the difference between min and max can not be larger than a
63-bit integer (i.e. the unsigned portion of a 64-bit signed integer).
The result is given as an int64.
Added in gomplate v3.4.0
Usage
Arguments
| name | description |
|---|---|
min |
(optional) The minimum value, defaults to 0. Must be less than max. |
max |
(optional) The maximum value, defaults to 100 (if no args provided) |
Examples
random.Float
Pick a random decimal floating-point number. By default, a number between
0.0 and 1.0 (exclusive, i.e. [0.0,1.0)) is chosen, but this range
can be overridden.
The result is given as a float64.
Added in gomplate v3.4.0
Usage
Arguments
| name | description |
|---|---|
min |
(optional) The minimum value, defaults to 0.0. Must be less than max. |
max |
(optional) The maximum value, defaults to 1.0 (if no args provided). |