L'expression NULLIF est une expression conditionnelle qui compare deux valeurs et renvoie null si elles sont égales ; sinon, elle renvoie la première valeur. Elle est souvent utilisée pour gérer les cas où des valeurs spécifiques doivent être traitées comme null, ce qui peut être utile pour le nettoyage conditionnel des données ou le traitement des valeurs par défaut.

<nullif expression> ::= 
  "NULLIF" "(" <value expression> "," <value expression> ")"

L'expression NULLIF(V1, V2) équivaut à l'expression CASE suivante :

CASE 
  WHEN V1 = V2 THEN NULL
  ELSE V1
END

Exemple de Graph

Les exemples suivants s'exécutent sur ce graph :

Pour créer ce graph, exécutez la requête suivante sur un graph vide :

INSERT (p1:Paper {_id:'P1', title:'Efficient Graph Search', score:6, author:'Alex', publisher:'PulsePress'}),
       (p2:Paper {_id:'P2', title:'Optimizing Queries', score:9, author:'Alex'}),
       (p3:Paper {_id:'P3', title:'Path Patterns', score:7, author:'Zack', publisher:'BrightLeaf'}),
       (p1)-[:Cites {weight:2}]->(p2),
       (p2)-[:Cites {weight:1}]->(p3)

Exemple

MATCH (n:Paper)
RETURN n.title, NULLIF(n.author, "Alex")

Résultat :