nushell/docs/commands/random.md

91 lines
3.8 KiB
Markdown

# random
Use `random` to generate random values
## bool
* `random bool`: Generate a random boolean value
### bool Flags
* `-b`, `--bias` \<number>: Adjusts the probability of a "true" outcome
### bool Examples
```shell
> random bool
false
```
```shell
> random bool --bias 0.75
true
```
## dice
* `random dice`: Generate a random dice roll
### dice Flags
* `d`, `--dice` \<integer>: The amount of dice being rolled
* `s`, `--sides` \<integer>: The amount of sides a die has
### dice Examples
```shell
> random dice
4
```
```shell
> random dice -d 10 -s 12
───┬────
011
111
211
311
45
53
610
77
83
91
───┴────
```
```shell
> random dice --dice 1024 --sides 16 | wrap dice | histogram dice | sort-by count
────┬──────┬───────┬──────────────────────────────────────────────────────────────────────────────────────────────────────
# │ dice │ count │ frequency
────┼──────┼───────┼──────────────────────────────────────────────────────────────────────────────────────────────────────
01554 │ ***********************************************************************
1755 │ ************************************************************************
2156 │ *************************************************************************
31657 │ ***************************************************************************
4557 │ ***************************************************************************
5361 │ ********************************************************************************
61162 │ *********************************************************************************
71464 │ ************************************************************************************
8965 │ *************************************************************************************
91266 │ **************************************************************************************
10467 │ ****************************************************************************************
11269 │ ******************************************************************************************
12869 │ ******************************************************************************************
13671 │ *********************************************************************************************
141375 │ **************************************************************************************************
151076 │ ****************************************************************************************************
────┴──────┴───────┴──────────────────────────────────────────────────────────────────────────────────────────────────────
```
## uuid
* `random uuid`: Generate a random uuid4 string
### uuid Examples
```shell
> random uuid
8af4de39-acbc-42f0-94d1-7cfad6c01f8b
```