If

If( cond_expr, true_expr, false_expr )

If( cond_expr, true_expr, false_expr )

If( cond_expr, true_expr, false_expr )

If( cond_expr, true_expr, false_expr )

if_( cond_expr, true_expr, false_expr )

if_( cond_expr, true_expr, false_expr )

If( cond_expr, true_expr, false_expr )

If( cond_expr, true_expr, false_expr )

Description

The If function evaluates and returns the true_expr or false_expr expression, depending on the value of the cond expression. If the cond expression evaluates to anything other than a Boolean, If returns an "invalid argument" error.

Any valid Fauna Query Language expression is acceptable, including null.

Parameters

Argument Type Definition and Requirements

Argument	Type	Definition and Requirements
`cond`	Boolean Expression	The conditional expression to evaluated and tested for `true` or `false`.
`true_expr`	Expression	The expression or variable to return if `cond` is `true`.
`false_expr`	Expression	The expression or variable to return if `cond` is `false`.

cond

Boolean Expression

The conditional expression to evaluated and tested for true or false.

true_expr

Expression

The expression or variable to return if cond is true.

false_expr

Expression

The expression or variable to return if cond is false.

Returns

The evaluation of either the true_expr or false_expr expression, depending on the evaluation of the cond expression.

Examples

The query below evaluates the cond expression, which is the condition that needs to be tested, and then determines that cond returns true. This causes the second argument, the true_expr expression, to be evaluated and returned. The third argument, the false_expr expression, is never evaluated.

curl https://db.fauna.com/ \
    -u fnAChGwBcAACAO70ziE0cfROosNJHdgBmJU1PgpL: \
    -d '{ "if": true, "then": "was true", "else": "was false" }'

client.Query(If(true, "was true", "was false"));

System.out.println(
         client.query(
                 If(Value(true), Value("was true"), Value("was false"))
         ).get() );

result, _ := client.Query(f.If(true, "was true", "was false"))

fmt.Println(result)

client.query(If(true, "was true", "was false"))

client.query(q.if_(True, "was true", "was false"))

$client.query do
  if_(true, 'was true', 'was false')
end

client.query(If(true, then: "was true", else: "was false"))

client.query(
  q.If(true, 'was true', 'was false')
)
.then((ret) => console.log(ret))

HTTP/1.1 200 OK
{ "resource": "was true" }

"was true"

"was true"

was true

"was true"

"was true"

"was true"

"was true"

"was true"

Was this article helpful?

We're sorry to hear that.
Tell us how we can improve! documentation@fauna.com

Thank you for your feedback!