Função NULLIF

Sintaxe

A expressão NULLIF compara dois argumentos e retorna nulo se os argumentos forem iguais. Se eles não forem iguais, o primeiro argumento é retornado. Essa expressão é o inverso da expressão NVL ou COALESCE.

NULLIF ( expression1, expression2 )

Argumentos

expression1, expression2

As colunas ou expressões de destino que são comparadas. O tipo de retorno é igual ao tipo da primeira expressão. O nome padrão da coluna do resultado de NULLIF é o nome da coluna da primeira expressão.

Exemplos

No exemplo a seguir, a consulta retorna a string first porque os argumentos não são iguais.

SELECT NULLIF('first', 'second');

case
-------
first	   

No exemplo a seguir, a consulta retorna NULL porque os argumentos literais da string são iguais.

SELECT NULLIF('first', 'first');

case
-------
NULL	   

No exemplo a seguir, a consulta retorna 1 porque os argumentos inteiros não são iguais.

SELECT NULLIF(1, 2);

case
-------
1	   

No exemplo a seguir, a consulta retorna NULL porque os argumentos inteiros são iguais.

SELECT NULLIF(1, 1);

case
-------
NULL	   

No exemplo a seguir, a consulta retorna nulo quando há correspondência dos valores LISTID e SALESID:

select nullif(listid,salesid), salesid
from sales where salesid<10 order by 1, 2 desc;

listid  | salesid
--------+---------
     4  |       2
     5  |       4
     5  |       3
     6  |       5
     10 |       9
     10 |       8
     10 |       7
     10 |       6
        |       1
(9 rows)