NULLIF スカラー関数
NULLIF 関数は、引数が等しい場合は NULL 値を戻し、 それ以外の場合には最初の引数の値を戻します。
スキーマは SYSIBM です。
- expression1
- 組み込みデータ・タイプまたはユーザー定義データ・タイプの値を返す式。
- expression2
- 等価比較の規則に従ってもう一方の引数のデータ・タイプと比較可能な、組み込みデータ・タイプまたはユーザー定義データ・タイプの値を戻す式です。
NULLIF(e1,e2) を使用した結果は、次の式を使用した結果と同じになります。
CASE WHEN e1=e2 THEN NULL ELSE e1 END一方または両方の引数が NULL で、e1=e2 が不明と評価されると、 CASE 式はこれを真ではないと見なします。 したがって、この場合、NULLIF は最初の引数の値を戻します。
注
- NULLIF 関数は、ユーザー定義関数の作成時にソース関数として使用することはできません。 この関数は、 すべての比較可能なデータ・タイプを引数として受け入れるので、ユーザー定義データ・タイプをサポートするための追加のシグニチャーを作成する必要はありません。
例
ホスト変数 PROFIT、CASH、および LOSSES のデータ・タイプが DECIMAL で、
値がそれぞれ 4500.00、500.00、および 5000.00 であるとします。
NULLIF (:PROFIT + :CASH , :LOSSES )