TRIM_ARRAY (fonction scalaire)

La fonction TRIM_ARRAY supprime des éléments de la fin d'un tableau.

Le schéma est SYSIBM.

expression-tableau

Variable SQL, paramètre SQL ou variable globale d'un type de tableau ordinaire, ou spécification CAST d'un marqueur de paramètre pour un type de tableau ordinaire. Un type de données de tableau associatif ne peut pas être indiqué (SQLSTATE 42884).

expression-numérique

Indique le nombre d'éléments tronqués à partir de la fin du tableau. L'expression numérique peut être de n'importe quel type de données numériques avec une valeur pouvant être transtypée en INTEGER. La valeur de l'expression numérique doit être comprise entre 0 et la cardinalité de l'expression de tableau (SQLSTATE 2202E).

Résultat

La fonction renvoie une valeur avec le même type de tableau que l'expression de tableau, mais avec la cardinalité réduite de la valeur de INTEGER (expression-numérique).

Le résultat peut être null ; si l'un des arguments est null, le résultat est la valeur null.

Règles

La fonction TRIM_ARRAY n'est pas prise en charge pour les tableaux associatifs (SQLSTATE 42884).
La fonction TRIM_ARRAY ne peut être utilisée que dans la partie droite d'une instruction d'affectation dans les contextes où les tableaux sont pris en charge (SQLSTATE 42884).

Exemples

Exemple 1: Supprimez le dernier élément de la variable de tableau RECENT_CALLS.
```
   SET RECENT_CALLS = TRIM_ARRAY(RECENT_CALLS, 1)
```
Exemple 2: Affectez uniquement les deux premiers éléments de la variable de tableau SPECIALNUMBERS à la variable de tableau SQL EULER_CONST:
```
SET EULER_CONST = TRIM_ARRAY(SPECIALNUMBERS, 8)
```
Le résultat est que EULER_CONST se verra affecter un tableau avec deux éléments, la valeur du premier élément est 2.71828183 et la valeur du second élément est la valeur null.