Le Tableau 9.41, � Op�rateurs pour les tableaux � pr�sente les op�rateurs disponibles pour les types tableaux.
Tableau 9.41. Op�rateurs pour les tableaux
| Op�rateur | Description | Exemple | R�sultat |
|---|---|---|---|
| = | �gal � | ARRAY[1.1,2.1,3.1]::int[] = ARRAY[1,2,3] | t |
| <> | diff�rent de | ARRAY[1,2,3] <> ARRAY[1,2,4] | t |
| < | inf�rieur � | ARRAY[1,2,3] < ARRAY[1,2,4] | t |
| > | sup�rieur � | ARRAY[1,4,3] > ARRAY[1,2,4] | t |
| <= | inf�rieur ou �gal � | ARRAY[1,2,3] <= ARRAY[1,2,3] | t |
| >= | sup�rieur ou �gal � | ARRAY[1,4,3] >= ARRAY[1,4,3] | t |
| @> | contient | ARRAY[1,4,3] @> ARRAY[3,1] | t |
| <@ | est contenu par | ARRAY[2,7] <@ ARRAY[1,7,4,2,6] | t |
| && | se chevauchent (ont des �l�ments en commun) | ARRAY[1,4,3] && ARRAY[2,1] | t |
| || | concat�nation de tableaux | ARRAY[1,2,3] || ARRAY[4,5,6] | {1,2,3,4,5,6} |
| || | concat�nation de tableaux | ARRAY[1,2,3] || ARRAY[[4,5,6],[7,8,9]] | {{1,2,3},{4,5,6},{7,8,9}} |
| || | concat�nation d'un �l�ment avec un tableau | 3 || ARRAY[4,5,6] | {3,4,5,6} |
| || | concat�nation d'un tableau avec un �l�ment | ARRAY[4,5,6] || 7 | {4,5,6,7} |
Les comparaisons de tableaux comparent les contenus des tableaux �l�ment par �l�ment, en utilisant la fonction de comparaison par d�faut du B-Tree pour le type de donn�es de l'�l�ment. Dans les tableaux multi-dimensionnels, les �l�ments sont visit�s dans l'ordre des colonnes (� row-major order �, le dernier indice varie le plus rapidement). Si le contenu de deux tableaux est identique mais que les dimensions sont diff�rentes, la premi�re diff�rence dans l'information de dimension d�termine l'ordre de tri. (Ce fonctionnement diff�re de celui des versions de PostgreSQL™ ant�rieures � la 8.2 : les anciennes versions indiquent que deux tableaux de m�me contenu sont identiques m�me si le nombre de dimensions ou les �chelles d'indices diff�rent.)
Voir la Section 8.15, � Tableaux � pour plus de d�tails sur le comportement des op�rateurs.
Le Tableau 9.42, � Fonctions pour les tableaux � pr�sente les fonctions utilisables avec des types tableaux. Voir la Section 8.15, � Tableaux � pour plus d'informations et des exemples d'utilisation de ces fonctions.
Tableau 9.42. Fonctions pour les tableaux
| Fonction | Type de retour | Description | Exemple | R�sultat |
|---|---|---|---|---|
| array_append (anyarray, anyelement) | anyarray | ajoute un �l�ment � la fin d'un tableau | array_append(ARRAY[1,2], 3) | {1,2,3} |
| array_cat (anyarray, anyarray) | anyarray | concat�ne deux tableaux | array_cat(ARRAY[1,2,3], ARRAY[4,5]) | {1,2,3,4,5} |
| array_ndims(anyarray) | int | renvoie le nombre de dimensions du tableau | array_ndims(ARRAY[[1,2,3], [4,5,6]]) | 2 |
| array_dims (anyarray) | text | renvoie une repr�sentation textuelle des dimensions d'un tableau | array_dims(array[[1,2,3], [4,5,6]]) | [1:2][1:3] |
| array_fill(anyelement, int[], [, int[]]) | anyarray | renvoie un tableau initialis� avec une valeur et des dimensions fournies, en option avec des limites basses autre que 1 | array_fill(7, ARRAY[3], ARRAY[2]) | [2:4]={7,7,7} |
| array_length(anyarray, int) | int | renvoie la longueur de la dimension du tableau | array_length(array[1,2,3], 1) | 3 |
| array_lower (anyarray, int) | int | renvoie la limite inf�rieure du tableau donn� | array_lower('[0:2]={1,2,3}'::int[], 1) | 0 |
| array_prepend (anyelement, anyarray) | anyarray | ajoute un �l�ment au d�but d'un tableau | array_prepend(1, ARRAY[2,3]) | {1,2,3} |
| array_to_string(anyarray, text [, text]) | text | concat�ne des �l�ments de tableau en utilisant le d�limiteur fourni et une cha�ne nulle optionnelle | array_to_string(ARRAY[1, 2, 3, NULL, 5], ',', '*') | 1,2,3,*,5 |
| array_upper (anyarray, int) | int | renvoie la limite sup�rieure du tableau donn� | array_upper(ARRAY[1,8,3,7], 1) | 4 |
| string_to_array(text, text [, text]) | text[] | divise une cha�ne en tableau d'�l�ments en utilisant le d�limiteur fourni et la cha�ne nulle optionnelle | string_to_array('xx~^~yy~^~zz', '~^~', 'yy') | {xx,NULL,zz} |
| unnest(anyarray) | setof anyelement | �tend un tableau � un ensemble de lignes | unnest(ARRAY[1,2]) |
1 2(2 rows) |
Dans string_to_array, si le d�limiteur vaut NULL, chaque caract�re de la cha�ne en entr�e deviendra un �l�ment s�par� dans le tableau r�sultant. Si le d�limiteur est une cha�ne vide, alors la cha�ne enti�re est renvoy�e dans un tableau � un �l�ment. Dans les autres cas, la cha�ne en entr�e est divis�e � chaque occurence du d�limiteur.
Dans string_to_array, si le param�tre cha�ne_null est omis ou vaut NULL, aucune des sous-cha�nes en entr�e ne sera remplac�e par NULL. Dans array_to_string, si le param�tre cha�ne_null est omis ou vaut NULL, tous les �l�ments NULL du tableau seront simplement ignor�s et non repr�sent�s dans la cha�ne en sortie.
![[Note]](images/note.png)
Il existe deux diff�rences dans le comportement de string_to_array avec les versions de PostgreSQL™ ant�rieures � la 9.1. Tout d'abord, il renverra un tableau vide (� z�ro �l�ment) plut�t que NULL quand la cha�ne en entr�e est de taille z�ro. Ensuite, si le d�limiteur vaut NULL, la fonction divise l'entr�e en caract�res individuels plut�t que de renvoyer NULL comme avant.
Voir aussi Section 9.20, � Fonctions d'agr�gat � � propose la fonction d'agr�gat array_agg � utiliser avec les tableaux.
Expressions conditionnelles
