NULLIF

📖 Описание

Функция Oracle/PLSQL NULLIF сравнивает expr1 и expr2. Если они равны, функция возвращает NULL. В противном случае она возвращает expr1.


🧩 Синтаксис

NULLIF(expr1, expr2)

⚙️ Параметры и аргументы

expr1 и expr2 должны быть числовыми либо иметь одинаковый нечисловой тип. Для числовых типов Oracle выбирает тип с более высоким приоритетом.

Примечание

  • При равенстве аргументов результат — NULL; иначе возвращается expr1.
  • expr1 может быть выражением, результат которого NULL, но нельзя передавать неявно типизированный литерал NULL первым аргументом.

💻 Примеры

SELECT NULLIF(27, 27) FROM dual;
-- Результат: NULL

SELECT NULLIF(27, 31) FROM dual;
-- Результат: 27

SELECT NULLIF('canvas', 'canvas') FROM dual;
-- Результат: NULL

SELECT NULLIF('canvas', 'paper') FROM dual;
-- Результат: canvas

-- Отдельный пример, намеренно вызывающий ошибку:
SELECT NULLIF(NULL, 27) FROM dual;
-- ORA-00932: первый аргумент не может быть литералом NULL

SELECT NULLIF(CAST(NULL AS NUMBER), 27) FROM dual;
-- Результат: NULL

Последний запрос использует CAST для явного типа. По смыслу NULLIF соответствует выражению CASE с проверкой равенства аргументов.

См. документацию Oracle: NULLIF.