Catégories :

Fonctions de chaîne et fonctions binaires (général)

TRIM

Supprime les caractères de début et de fin d’une chaîne.

Note

Pour retirer des caractères d’une chaîne, vous pouvez utiliser la fonction REPLACE.

Voir aussi ::

LTRIM, RTRIM, Types de données Chaîne et Binaire

Syntaxe

TRIM( <expr> [, <characters> ] )
Copy

Arguments

expr

Une expression de chaîne à couper.

characters

Un ou plusieurs caractères à retirer des côtés gauche et droit de expr :

La valeur par défaut est ' ' (un seul caractère d’espace vide). Si aucun caractère n’est spécifié, seuls les espaces vides sont retirés.

Renvoie

Cette fonction renvoie une valeur de type de données VARCHAR ou NULL. Si l’un des arguments est NULL, renvoie NULL.

Notes sur l’utilisation

  • Vous pouvez spécifier les caractères dans characters dans n’importe quel ordre.

  • Une spécification de ' ' dans characters ne retire pas d’autres caractères d’espace blanc (tels que les caractères de tabulation, les caractères de fin de ligne, etc.). Spécifiez explicitement ces caractères pour les retirer.

  • Pour supprimer les espaces, les caractères doivent être explicitement inclus dans l’argument. Par exemple, ' $.' retire tous les espaces vides, les signes dollar et les points de début et de fin de la chaîne d’entrée.

Détails du classement

Le classement est pris en charge lorsque le deuxième argument facultatif est omis ou lorsqu’il ne contient que des espaces blancs.

La spécification de classement de la valeur renvoyée est identique à la spécification de classement du premier argument.

Exemples

Supprimez les * et - caractères d’une chaîne :

SELECT '*-*ABC-*-' AS original,
       TRIM('*-*ABC-*-', '*-') AS trimmed;
Copy
+-----------+---------+
| ORIGINAL  | TRIMMED |
|-----------+---------|
| *-*ABC-*- | ABC     |
+-----------+---------+

Supprimez une nouvelle ligne de fin d’une chaîne. Cet exemple utilise la fonction CONCAT pour entourer les chaînes de caractères > et < pour vous aider à visualiser l’espace blanc.

SELECT CONCAT('>', CONCAT('ABC\n', '<')) AS original,
       CONCAT('>', CONCAT(TRIM('ABC\n', '\n'), '<')) AS trimmed;
Copy
+----------+---------+
| ORIGINAL | TRIMMED |
|----------+---------|
| >ABC     | >ABC<   |
| <        |         |
+----------+---------+

Supprimez les espaces de début et de fin d’une chaîne. Cet exemple encadre les chaînes de caractères > et < pour vous aider à visualiser l’espace blanc. Il montre également que la fonction renvoie NULL pour l’entrée NULL.

CREATE OR REPLACE TABLE test_trim_function(column1 VARCHAR);

INSERT INTO test_trim_function VALUES ('  Leading Spaces'), ('Trailing Spaces  '), (NULL);

SELECT CONCAT('>', CONCAT(column1, '<')) AS original_values,
       CONCAT('>', CONCAT(TRIM(column1), '<')) AS trimmed_values
  FROM test_trim_function;
Copy
+---------------------+-------------------+
| ORIGINAL_VALUES     | TRIMMED_VALUES    |
|---------------------+-------------------|
| >  Leading Spaces<  | >Leading Spaces<  |
| >Trailing Spaces  < | >Trailing Spaces< |
| NULL                | NULL              |
+---------------------+-------------------+
Langage: Français