- Categories:
NULLIFZEROΒΆ
Returns NULL if the argument evaluates to 0
; otherwise, returns the argument.
SyntaxΒΆ
NULLIFZERO( <expr> )
ArgumentsΒΆ
expr
The input should be an expression that evaluates to a numeric value.
ReturnsΒΆ
If the value of the input expression is 0
, this returns NULL.
Otherwise, this returns the value of the input expression.
The data type of the return value is NUMBER(p, s)
(if the input is a
fixed-point number) or DOUBLE
(if the
input is a floating point number).
For fixed-point numbers, the exact values of βpβ (precision) and βsβ (scale) depend upon the input expression. For example,
if the input expression is 3.14159, then the data type of the output value will be NUMBER(7, 5)
.
ExamplesΒΆ
The following examples show the output of the function for various input values:
SELECT NULLIFZERO(0); +---------------+ | NULLIFZERO(0) | |---------------| | NULL | +---------------+SELECT NULLIFZERO(52); +----------------+ | NULLIFZERO(52) | |----------------| | 52 | +----------------+SELECT NULLIFZERO(3.14159); +---------------------+ | NULLIFZERO(3.14159) | |---------------------| | 3.14159 | +---------------------+