FirebirdSQL logo

COALESCE()

Disponible en

DSQL, PSQL

Syntaxe
COALESCE (<exp1>, <exp2> [, <expN> ... ])
Table 1. paramètres de fonction COALESCE
Paramètre Description

exp1, exp2 …​ expN

Expressions de tout type compatible.

type de résultat de retour

dépend des types d’arguments d’entrée

La fonction COALESCE prend deux arguments ou plus et retourne la valeur du premier argument non NULL. Si tous les arguments sont NULL, le résultat est également NULL.

Exemple COALESCE

Example 1. Utilisation de la fonction COALESCE

Cet exemple tente d’utiliser toutes les données disponibles pour composer un nom complet. Le champ NICKNAME de la table PERSONS est sélectionné. S’il est NULL, la valeur du champ FIRSTNAME est prise. S’il est également NULL, la chaîne de caractères "Mr./Mrs.`" est utilisée. Ensuite le nom de famille (le champ `LASTNAME) est ajouté à la valeur de la fonction COALESCE. Notez que ce schéma ne fonctionne correctement que si les champs à sélectionner sont NULL ou non vides : si l’un d’eux est une chaîne vide, c’est ce qui sera renvoyé comme valeur de la fonction COALESCE.

SELECT
  COALESCE(PE.NICKNAME, PE.FIRSTNAME, 'Mr./Mrs.') ||
  ' ' || PE.LASTNAME AS FULLNAME
FROM PERSONS PE
Example 2. Utilisation de la fonction COALESCE avec des fonctions agrégées

Dans cet exemple, si la requête renvoie NULL lors du calcul de la somme, elle renverra 0.

SELECT coalesce (sum (q), 0)
FROM bills
WHERE ...
Voir aussi :

CASE.