mirror of
https://github.com/gohugoio/hugo.git
synced 2024-12-01 12:58:54 -05:00
32 lines
1,014 B
Markdown
32 lines
1,014 B
Markdown
---
|
|
title: compare.Conditional
|
|
description: Returns one of two arguments depending on the value of the control argument.
|
|
categories: []
|
|
keywords: []
|
|
action:
|
|
aliases: [cond]
|
|
related:
|
|
- functions/compare/Default
|
|
returnType: any
|
|
signatures: [compare.Conditional CONTROL ARG1 ARG2]
|
|
aliases: [/functions/cond]
|
|
---
|
|
|
|
If CONTROL is truthy the function returns ARG1, otherwise it returns ARG2.
|
|
|
|
```go-html-template
|
|
{{ $qty := 42 }}
|
|
{{ cond (le $qty 3) "few" "many" }} → many
|
|
```
|
|
|
|
Unlike [ternary operators] in other languages, the `compare.Conditional` function does not perform [short-circuit evaluation]. It evaluates both ARG1 and ARG2 regardless of the CONTROL value.
|
|
|
|
[short-circuit evaluation]: https://en.wikipedia.org/wiki/Short-circuit_evaluation
|
|
[ternary operators]: https://en.wikipedia.org/wiki/Ternary_conditional_operator
|
|
|
|
Due to the absence of short-circuit evaluation, these examples throw an error:
|
|
|
|
```go-html-template
|
|
{{ cond true "true" (div 1 0) }}
|
|
{{ cond false (div 1 0) "false" }}
|
|
```
|