Module to generate string related entries.Overview
For a string containing just A-Z characters, use {{$string.alpha}}. To add digits too, use {{$string.alphanumeric}}. If you only want punctuation marks/symbols, use {{$string.symbol}}. For a full set of ASCII characters, use {{$string.sample}}. For a custom set of characters, use {{$string.fromCharacters}}.For strings of base-ten digits, use {{$string.numeric}}. For other bases, use {{$string.binary}}, {{$string.octal}}, or {{$string.hexadecimal}}).You can generate standard ID strings using {{$string.uuid}} or {{$string.nanoid}}.Related modules
Emoji can be found at {{$internet.emoji}}.
The Helpers module includes a number of string related methods.
alpha#
Generating a string consisting of letters in the English alphabet.| Name | Type | Default | Description |
|---|
| casing | Casing | mixed | The casing of the characters. |
| exclude | string | Array<AlphaChar | string> | [] | An array with characters which should be excluded in the generated string. |
| min | number | 1 | The minimum number of characters to generate. |
| max | number | 1 | The maximum number of characters to generate. |
| length | number | 1 | The range of characters to generate. |
alphanumeric#
Generating a string consisting of alpha characters and digits.| Name | Type | Default | Description |
|---|
| casing | Casing | mixed | The casing of the characters. |
| exclude | string | Array<AlphaNumericChar | string> | [] | An array with characters which should be excluded in the generated string. |
| min | number | 1 | The minimum number of characters to generate. |
| max | number | 1 | The maximum number of characters to generate. |
| length | number | 1 | The range of characters to generate. |
binary#
| Name | Type | Default | Description |
|---|
| prefix | string | 0b | Prefix for the generated number. |
| min | number | 1 | The minimum number of characters to generate after the prefix. |
| max | number | 1 | The maximum number of characters to generate after the prefix. |
| length | number | 1 | The range of characters to generate. |
fromCharacters#
Generates a string from the given characters.| Name | Type | Default | Description |
|---|
| characters | string | string[] | | The characters to use for the string. Can be a string or an array of characters. If it is an array, then each element is treated as a single character even if it is a string with multiple characters. |
| min | number | | The minimum length of the string to generate. |
| max | number | | The maximum length of the string to generate. |
hexadecimal#
| Name | Type | Default | Description |
|---|
| casing | Casing | mixed | The casing of the characters. |
| prefix | string | 0x | Prefix for the generated number. |
| min | number | 1 | The minimum number of characters to generate after the prefix. |
| max | number | 1 | The maximum number of characters to generate after the prefix. |
| length | number | 1 | The range of characters to generate after the prefix. |
nanoid#
| Name | Type | Default | Description |
|---|
| min | number | 1 | The minimum length of the Nano ID to generate. |
| max | number | 1 | The maximum length of the Nano ID to generate. |
| length | number | 21 | Length of the generated string. |
numeric#
Generates a given length string of digits.| Name | Type | Default | Description |
|---|
| exclude | string | Array<NumericChar | string> | [] | An array of digits which should be excluded in the generated string. |
| allowLeadingZeros | boolean | true | Whether leading zeros are allowed or not. |
| min | number | 1 | The minimum of digits to generate. |
| max | number | 1 | The maximum of digits to generate. |
| length | number | 1 | The range of digits to generate. |
octal#
| Name | Type | Default | Description |
|---|
| min | number | 1 | The minimum of digits to generate after the prefix. |
| max | number | 1 | The maximum of digits to generate after the prefix. |
| length | number | 1 | The range of digits to generate after the prefix. |
| prefix | string | 0o | Prefix for the generated number. |
sample#
Returns a string containing UTF-16 chars between 33 and 125 (! to }).| Name | Type | Default | Description |
|---|
| min | number | | The minimum number of characters to generate. |
| max | number | | The maximum number of characters to generate. |
symbol#
Returns a string containing only special characters from the following list:| Name | Type | Default | Description |
|---|
| min | number | | The minimum number of special characters to generate. |
| max | number | | The maximum number of special characters to generate. |
uuid#
Modified atΒ 2024-09-02 06:43:20