| The jOOQ User Manual. Multiple Pages : SQL building : Column expressions : General functions : NVL2 | previous : next |
New versions: Dev (3.14) | Latest (3.13) | 3.12 | 3.11 | 3.10 | 3.9 | 3.8 | Old versions: 3.7 | 3.6 | 3.5 | 3.4 | 3.3
NVL2
Applies to ✅ Open Source Edition ✅ Express Edition ✅ Professional Edition ✅ Enterprise Edition
The NVL2() function checks if the first argument is NOT NULL to produce the second argument, or the third argument otherwise. It works in a similar way as CASE expression
SELECT nvl2(1, 2, 3), nvl2(null, 2, 3);
create.select( nvl2(val(1) , 2, 3), nvl2(val(null), 2, 3)).fetch();
The result being
+------+------+ | nvl2 | nvl2 | +------+------+ | 2 | 3 | +------+------+
Dialect support
This example using jOOQ:
nvl2(val(1), 2, 3)
Translates to the following dialect specific expressions:
-- ACCESS, SQLSERVER iif(1 IS NOT NULL, 2, 3) -- ASE, AURORA_MYSQL, AURORA_POSTGRES, COCKROACHDB, CUBRID, DB2, DERBY, FIREBIRD, HANA, INFORMIX, MARIADB, MEMSQL, MYSQL, -- POSTGRES, REDSHIFT, SQLDATAWAREHOUSE, SQLITE, SYBASE, TERADATA, VERTICA CASE WHEN 1 IS NOT NULL THEN 2 ELSE 3 END -- H2, HSQLDB, INGRES, ORACLE nvl2(1, 2, 3)
(These are currently generated with jOOQ 3.14, see #10141)
