Catégories :

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

LTRIM

Supprime les caractères d’en-tête, 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 ::

RTRIM, TRIM

Syntaxe

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

Arguments

expr

L’expression de chaîne à couper.

characters

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

Retirez les caractères 0 et # de début d’une chaîne :

SELECT LTRIM('#000000123', '0#');
Copy
+---------------------------+
| LTRIM('#000000123', '0#') |
|---------------------------|
| 123                       |
+---------------------------+

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_ltrim_function(column1 VARCHAR);

INSERT INTO test_ltrim_function VALUES ('  #Leading Spaces');
Copy

Retirez l’espace blanc de début 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(LTRIM(column1), '<')) AS trimmed_value
  FROM test_ltrim_function;
Copy
+---------------------+-------------------+
| ORIGINAL_VALUE      | TRIMMED_VALUE     |
|---------------------+-------------------|
| >  #Leading Spaces< | >#Leading 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(LTRIM(column1, ' #'), '<')) AS trimmed_value
  FROM test_ltrim_function;
Copy
+---------------------+------------------+
| ORIGINAL_VALUE      | TRIMMED_VALUE    |
|---------------------+------------------|
| >  #Leading Spaces< | >Leading Spaces< |
+---------------------+------------------+
Langage: Français