quiet

Function

  quiet — quiet “missing” errors

Synopsis

quiet(val: any) -> any

Description

The quiet function returns its argument val unless val is error("missing"), in which case it returns error("quiet"). Various operators and functions treat quiet errors differently than missing errors, in particular, dropping them instead of propagating them. Quiet errors are ignored by operators aggregate, cut, and values.

Examples

Values processes a quiet error and thus no output:

values quiet(this)

error("missing")

Loading...

echo 'error("missing")' \
| super -s -c 'values quiet(this)' -

Without quiet, values produces the missing error:

values this

error("missing")

Loading...

echo 'error("missing")' \
| super -s -c 'values this' -

The cut operator drops quiet errors but retains missing errors:

cut b:=x+1,c:=quiet(x+1),d:=quiet(a+1)

{a:1}

Loading...

echo '{a:1}' \
| super -s -c 'cut b:=x+1,c:=quiet(x+1),d:=quiet(a+1)' -