mirror of
https://github.com/nushell/nushell.git
synced 2024-12-02 13:24:30 +01:00
35 lines
638 B
Markdown
35 lines
638 B
Markdown
---
|
|
title: if
|
|
layout: command
|
|
version: 0.59.1
|
|
---
|
|
|
|
Conditionally run a block.
|
|
|
|
## Signature
|
|
|
|
```> if (cond) (then_block) (else_expression)```
|
|
|
|
## Parameters
|
|
|
|
- `cond`: condition to check
|
|
- `then_block`: block to run if check succeeds
|
|
- `else_expression`: expression or block to run if check fails
|
|
|
|
## Examples
|
|
|
|
Output a value if a condition matches, otherwise return nothing
|
|
```shell
|
|
> if 2 < 3 { 'yes!' }
|
|
```
|
|
|
|
Output a value if a condition matches, else return another value
|
|
```shell
|
|
> if 5 < 3 { 'yes!' } else { 'no!' }
|
|
```
|
|
|
|
Chain multiple if's together
|
|
```shell
|
|
> if 5 < 3 { 'yes!' } else if 4 < 5 { 'no!' } else { 'okay!' }
|
|
```
|