Catégories :

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

RTRIM

Supprime les caractères de fin de ligne, y compris les espaces, d’une chaîne.

Note

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

Voir aussi ::

LTRIM, TRIM

Syntaxe

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

Arguments

expr

L’expression de chaîne à couper.

characters

Un ou plusieurs caractères à supprimer du côté 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.

  • Lorsque characters est spécifié, vous devez spécifier explicitement les caractères pour retirer les espaces blancs. Par exemple, ' $.' supprime tous les espaces vides, les signes dollar et les points 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 caractères 0 et . de fin d’une chaîne :

SELECT RTRIM('$125.00', '0.');
Copy
+------------------------+
| RTRIM('$125.00', '0.') |
|------------------------|
| $125                   |
+------------------------+

Les autres exemples utilisent les données de table suivantes. En outre, les requêtes encadrent les chaînes de caractères > et < pour vous aider à visualiser l’espace blanc.

CREATE OR REPLACE TABLE test_rtrim_function(column1 VARCHAR);

INSERT INTO test_rtrim_function VALUES ('Trailing Spaces#  ');
Copy

Supprimez les espaces de fin d’une chaîne. Cet exemple ne spécifie pas le deuxième argument characters, car, par défaut, il s’agit d’espaces vides.

SELECT CONCAT('>', CONCAT(column1, '<')) AS original_value,
       CONCAT('>', CONCAT(RTRIM(column1), '<')) AS trimmed_value
  FROM test_rtrim_function;
Copy
+----------------------+--------------------+
| ORIGINAL_VALUE       | TRIMMED_VALUE      |
|----------------------+--------------------|
| >Trailing Spaces#  < | >Trailing Spaces#< |
+----------------------+--------------------+

Retirez # et l’espace blanc de début d’une chaîne. Cet exemple spécifie le deuxième argument characters, car il retire d’autres caractères en plus des espaces vides.

SELECT CONCAT('>', CONCAT(column1, '<')) AS original_value,
       CONCAT('>', CONCAT(RTRIM(column1, '# '), '<')) AS trimmed_value
  FROM test_rtrim_function;
Copy
+----------------------+-------------------+
| ORIGINAL_VALUE       | TRIMMED_VALUE     |
|----------------------+-------------------|
| >Trailing Spaces#  < | >Trailing Spaces< |
+----------------------+-------------------+
Langage: Français