FirebirdSQL logo
 fonctions scalairesFonctions Window (analytique) 

LIST()

Disponible en

DSQL

Syntaxe
LIST([ALL | DISTINCT] <expr> [, separator])
Table 1. paramètres de fonction LIST
Paramètre Description

expr

Expression : peut contenir une colonne de table, une constante, une variable, une expression, une fonction non agrégée ou une UDR qui renvoie un type de données chaîne ou BLOB. Les champs de type date/heure et numérique sont convertis en chaîne. Les fonctions agrégées ne sont pas autorisées comme expression.

separator

Separator : Une expression de type chaîne de caractères. Le séparateur par défaut est une virgule.
type de résultat de retour

BLOB

La fonction LIST renvoie une chaîne de caractères composée des valeurs des arguments autres que NULL dans le groupe,séparés par une virgule ou un délimiteur défini par l’utilisateur.S’il n’y a pas d’autres valeurs que NULL (y compris le cas où le groupe est vide), NULL est retourné.

  • ALL (par défaut) permet de traiter toutes les valeurs autres que NULL.Si le mot-clé DISTINCT est spécifié, les doublons sont supprimés sauf si expr est BLOB.

  • L’argument facultatif separator peut être une expression de type chaîne.Cela vous permet de spécifier, par exemple, ascii_char (13) comme séparateur.

  • Les arguments expr et separator prennent en charge les BLOB de toute taille et de tout jeu de caractères.

  • Les arguments numériques et de date/heure sont implicitement convertis en chaînes de caractères avant la fusion.

  • Le résultat de la fonction est un BLOB textuel, sauf si expr est un BLOB d’un sous-type différent.

  • L’ordre des valeurs dans la liste n’est pas défini — l’ordre dans lequel les lignes sont jointes est déterminé par l’ordre de lecture de l’ensemble de données original.Pour les tableaux, cet ordre n’est normalement pas défini.Si l’ordre est important, les données brutes peuvent être pré-triées à l’aide d’un dérivateur de tableau ou d’un outil similaire.

Exemples LIST

Example 1. En utilisant la fonction LIST

Obtention d’une liste, ordre indéfini.

SELECT LIST (display_name, '; ')
FROM GR_WORK;
Example 2. En utilisant la fonction LIST ordonné

Obtenez une liste par ordre alphabétique.

SELECT LIST (display_name, '; ')
FROM (SELECT display_name
      FROM GR_WORK
      ORDER BY display_name);
Voir aussi :

SELECT.