9.14. Fonctions et opérateurs sur les tableaux

Tableau 9-41 affiche les opérateurs disponibles pour les types array.

Tableau 9-41. Opérateurs array

OpérateurDescriptionExempleRésultat
= égal àARRAY[1.1,2.1,3.1]::int[] = ARRAY[1,2,3]t
<> différent deARRAY[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
|| concaténation de tableauxARRAY[1,2,3] || ARRAY[4,5,6]{1,2,3,4,5,6}
|| concaténation de tableauxARRAY[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 tableau3 || ARRAY[4,5,6]{3,4,5,6}
|| concaténation d'un tableau avec un élémentARRAY[4,5,6] || 7{4,5,6,7}

Voir Section 8.10 pour plus de détails sur le comportement des opérateurs.

Tableau 9-42 affiche les fonctions disponibles à l'utilisation avec des types tableaux. Voir Section 8.10 pour plus de discussion et d'exemples d'utilisation de ces fonctions.

Tableau 9-42. Fonctions sur array

FonctionType de retourDescriptionExempleRésultat
array_cat (anyarray, anyarray) anyarrayconcatène deux tableaux, renvoyant NULL si les deux entrées sont NULLarray_cat(ARRAY[1,2,3], ARRAY[4,5]){1,2,3,4,5}
array_append (anyarray, anyelement) anyarrayajoute un élément à la fin d'un tableau, renvoyant NULL dans le cas d'une entrée NULLarray_append(ARRAY[1,2], 3){1,2,3}
array_prepend (anyelement, anyarray) anyarrayajoute un élément au début d'un tableau, renvoyant NULL dans le cas d'une entrée NULLarray_prepend(1, ARRAY[2,3]){1,2,3}
array_dims (anyarray) textrenvoie une représentation textuelle des dimensions inférieure et supérieure d'un tableau et générant une erreur pour les entrées NULLarray_dims(array[[1,2,3], [4,5,6]])[1:2][1:3]
array_lower (anyarray, integer) integerrenvoie la dimension inférieure du tableau donné et renvoyant NULL pour des entrées NULLarray_lower(array_prepend(0, ARRAY[1,2,3]), 1)0
array_upper (anyarray, integer) integerrenvoie la dimension supérieure du tableau donné et renvoyant NULL pour les entrées NULLarray_upper(ARRAY[1,2,3,4], 1)4
array_to_string (anyarray, text) textconcatène des éléments de tableau en utilisant le délimiteur fourni, et renvoyant NULL pour les entrées NULLarray_to_string(array[1, 2, 3], '~^~')1~^~2~^~3
string_to_array (text, text) text[]divise une chaîne en tableau d'éléments utilisant le délimiteur fourni, et renvoyant NULL sur des entrées NULLstring_to_array( 'xx~^~yy~^~zz', '~^~'){xx,yy,zz}