if

For core.

Conditionally run a block.

Command Type

keyword

Signature

> if {flags} (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 when the condition is false.

Input/output types:

input output
any any

Examples

Output a value if a condition matches, otherwise return nothing.

> if 2 < 3 { 'yes!' }
yes!

Output a value if a condition matches, else return another value.

> if 5 < 3 { 'yes!' } else { 'no!' }
no!

Chain multiple if’s together.

> if 5 < 3 { 'yes!' } else if 4 < 5 { 'no!' } else { 'okay!' }
no!

Notes

This command is a parser keyword. For details, check: https://www.nushell.sh/book/thinking_in_nu.html

Ported from nushell/nushell.github.io. Copyright (c) 2021 Nushell Project. MIT License.