Logical
Logical functions reference.
This page describes the RawTree engine binary used to generate this reference. It does not define Query API support. Descriptions retain upstream ClickHouse terminology. See SQL interface scope.
and
Calculates the logical conjunction of two or more values.
Setting short_circuit_function_evaluation controls whether short-circuit evaluation is used.
If enabled, val_i is evaluated only if (val_1 AND val_2 AND ... AND val_{i-1}) is true.
For example, with short-circuit evaluation, no division-by-zero exception is thrown when executing the query SELECT and(number = 2, intDiv(1, number)) FROM numbers(5).
Zero as an argument is considered false, non-zero values are considered true.
Syntax
and(val1, val2[, ...])Arguments
val1, val2[, ...]— List of at least two values.Nullable((U)Int*)orNullable(Float*)
Returned value
Returns:
0, if at least one argument evaluates tofalseNULL, if no argument evaluates tofalseand at least one argument isNULL1, otherwiseNullable(UInt8)
Examples
Basic usage
SELECT and(0, 1, -2);0With NULL
SELECT and(NULL, 1, 10, -2);ᴺᵁᴸᴸIntroduced in version 1.1.0.
not
Calculates the logical negation of a value.
Zero as an argument is considered false, non-zero values are considered true.
Syntax
not(val)Arguments
Returned value
Returns:
1, ifvalevaluates tofalse0, ifvalevaluates totrueNULL, ifvalisNULL.Nullable(UInt8)
Examples
Basic usage
SELECT NOT(1);0Introduced in version 1.1.0.
or
Calculates the logical disjunction of two or more values.
Setting short_circuit_function_evaluation controls whether short-circuit evaluation is used.
If enabled, val_i is evaluated only if ((NOT val_1) AND (NOT val_2) AND ... AND (NOT val_{i-1})) is true.
For example, with short-circuit evaluation, no division-by-zero exception is thrown when executing the query SELECT or(number = 0, intDiv(1, number) != 0) FROM numbers(5).
Zero as an argument is considered false, non-zero values are considered true.
Syntax
or(val1, val2[, ...])Arguments
val1, val2[, ...]— List of at least two values.Nullable((U)Int*)orNullable(Float*)
Returned value
Returns:
1, if at least one argument evaluates totrue0, if all arguments evaluate tofalseNULL, if all arguments evaluate tofalseand at least one argument isNULLNullable(UInt8)
Examples
Basic usage
SELECT or(1, 0, 0, 2, NULL);1With NULL
SELECT or(0, NULL);ᴺᵁᴸᴸIntroduced in version 1.1.0.
xor
Calculates the logical exclusive disjunction of two or more values.
For more than two input values, the function first xor-s the first two values, then xor-s the result with the third value etc.
Zero as an argument is considered false, non-zero values are considered true.
Syntax
xor(val1, val2[, ...])Arguments
val1, val2[, ...]— List of at least two values.Nullable((U)Int*)orNullable(Float*)
Returned value
Returns:
1, for two values: if one of the values evaluates tofalseand other does not0, for two values: if both values evaluate tofalseor to bothtrueNULL, if at least one of the inputs isNULL.Nullable(UInt8)
Examples
Basic usage
SELECT xor(0, 1, 1);0Introduced in version 1.1.0.