Categories:

Conditional expression functions

NULLIFZEROΒΆ

Returns NULL if the argument evaluates to 0; otherwise, returns the argument.

SyntaxΒΆ

NULLIFZERO( <expr> )
Copy

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 |
+---------------+
Copy
SELECT NULLIFZERO(52);
+----------------+
| NULLIFZERO(52) |
|----------------|
|             52 |
+----------------+
Copy
SELECT NULLIFZERO(3.14159);
+---------------------+
| NULLIFZERO(3.14159) |
|---------------------|
|             3.14159 |
+---------------------+
Copy