📖

Author: codemasher

README.md

@@ -40,10 +40,11 @@ This library features some common functions to reduce overall duplication and av
 
 (we can't use `array` as class name because reasons)
 
-| method                           | description                                                                |
-|----------------------------------|----------------------------------------------------------------------------|
-| `Arr::first(array $array):mixed` | Returns the first element of an array, `null` if the given array is empty. |
-| `Arr::last(array $array):mixed`  | Returns the last element of an array, `null` if the given array is empty.  |
+| method                            | description                                                                |
+|-----------------------------------|----------------------------------------------------------------------------|
+| `Arr::first(array $array):mixed`  | Returns the first element of an array, `null` if the given array is empty. |
+| `Arr::last(array $array):mixed`   | Returns the last element of an array, `null` if the given array is empty.  |
+| `Arr::random(array $array):mixed` | Returns a random element of an array, `null` if the given array is empty.  |
 
 
 ### `Crypto`
@@ -61,14 +62,14 @@ The `Crypto` class defines the following public constants:
 
 pre-defined character maps for use with `Crypto::randomString()` as  `$keyspace`:
 
-- `NUMERIC`: numbers 0-9
-- `ASCII_LOWER`: ASCII a-z
-- `ASCII_UPPER`: ASCII A-Z
+- `NUMERIC`: numbers `0-9`
+- `ASCII_LOWER`: ASCII `a-z`
+- `ASCII_UPPER`: ASCII `A-Z`
 - `ASCII_SYMBOL`: ASCII printable symbols  ``!"#$%&\'()*+,-./:;<=>?@[\]^_`{|}~``
-- `HEXADECIMAL`: numbers 0-9 + ASCII a-f
-- `ASCII_ALPHANUM`: numbers 0-9 + ASCII a-z + A-Z
-- `ASCII_PRINTABLE`: numbers 0-9 + ASCII a-z + A-Z + printable symbols
-- `ASCII_COMMON_PW`: ASCII printable minus a few troublemaker symbols `!#$%&()*+,-./:;<=>?@[]~_|`
+- `HEXADECIMAL`: numbers `0-9` + ASCII `a-f`
+- `ASCII_ALPHANUM`: numbers `0-9` + ASCII `a-z` + `A-Z`
+- `ASCII_PRINTABLE`: numbers `0-9` + ASCII `a-z` + `A-Z` + printable symbols
+- `ASCII_COMMON_PW`: ASCII alphanum + most of ASCII printable symbols `!#$%&()*+,-./:;<=>?@[]~_|` (minus a few troublemakers)
 
 output and input `$format` for the functions `Crypto::encrypt()` and `Crypto::decrypt()`, respectively: